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Traitement de documents XML 

XSLT est un langage ne de la necessite de traiter des documents XML. 

Traiter des documents XML est de fait une necessite, etant donne son utilisation massive 
dans un grand nombre de secteurs de l'infonnatique, mais traiter un document XML par 
XSLT n'en n'est pas une : ce n'est qu'une possibility parmi d'autres. Actuellement, il y a 
trois voies differentes pour le traitement d'un document XML : 

• On peut utiliser une feuille de style CSS, si le but est uniquement un habillage HTML 
du document XML : les possibilites se reduisent en gros a des choix de rendu d' aspect 
du document, comme la taille d'une fonte, l'epaisseur d'un cadre, etc. II est impossible 
de modifier la structure du document, mais dans des cas tres simples, et a condition 
que le traitement puisse etre confie a un navigateur, cela peut suffire. 

• On peut developper un programme de traitement, par exemple en Java, ou en d'autres 
langages permettant d'acceder facilement a la representation arborescente d'un docu- 
ment XML (avec Java, par exemple, on dispose d' API comme DOM, JDOM ou SAX 
pour ce faire). Dans ce cas, il n'y a aucune limitation, on fait ce qu'on veut, et oii on 
veut (aussi bien sur un serveur que sur un poste client). 

• Enfin, on peut utiliser XSL (extensible Stylesheet Language), qui regroupe des lan- 
gages specifiques pour la description de transformations et de rendu de document 
XML, dont XSLT fait partie. II n'y a en principe pas de limitation theorique a la nature 
des traitements realisables par XSL, du moment qu'on s'en tient a vouloir traiter des 
documents XML ; XSL est utilisable aussi bien sur le poste client que sur un serveur. 

Comme XSL est specialement adapte au traitement de documents XML, on peut penser 
qu'il est plus simple de realiser le traitement desire en XSL, plutot que d' utiliser un langage 
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generaliste comme Java ou C++. C'est vrai, mais cette affirmation doit etre largement 
nuancee dans la pratique. En effet, un des problemes de XSL en general et de XSLT en 
particulier, est que ce sont des langages assez destabilisants, dans la mesure oil ils 
demandent aux programmeurs des competences dans des domaines qui sont generale- 
ment assez peu frequentes. Un expert XSLT mettra tres certainement beaucoup moins de 
temps a realiser le traitement demande que 1' expert Java utilisant les API SAX (Simple 
API for XML) ou DOM (Document Object Model) pour faire le meme travail ; le seul 
probleme, a vrai dire, est d'etre expert XSLT. 

A titre de comparaison, lorsque le langage Java a ete rendu public et disponible, un expert 
C++ ou Smalltalk (ou langage a objets, d'une facon plus generale) a qui Ton presentait ce 
langage, en faisait le tour en une semaine, le temps de s'habituer aux caracteristiques spe- 
cifiques ; mais son mode de pensee restait fondamentalement intact. 

A l'inverse, prenez un expert SQL, ou Java, ou C, ou Visual Basic, et presentez-lui 
XSLT : il n'aura pratiquement rien a quoi se raccrocher ; tout pour lui sera nouveau ou 
presque, sauf s'il a une bonne culture dans le domaine des langages fonctionnels ou 
declaratifs (Prolog, Lisp, Caml, etc.). 

Pourtant, il ne faut pas croire que XSLT soit un langage specialement difficile ou com- 
plexe ; il est meme beaucoup moins complexe que C++. Mais il est deroutant, parce qu'il 
nous fait penetrer dans un monde auquel nous ne sommes en general pas habitues. 

En resume, si vous avez a faire un traitement non trivial sur un document XML, et que 
vous etes novice en XSLT, prevoyez une phase importante d'investissement personnel 
initial dans le calcul de votre delai, ou realisez votre traitement en programmation tradi- 
tionnelle, avec des API comme SAX ou DOM. Mais ce n'est pas une solution rentable a 
moyen terme, car il est certain qu'une fois la competence acquise, on est beaucoup plus 
efficace en XSLT qu'on peut l'etre en Java ou C++ pour realiser une transformation 
donnee. 

Le langage XSL 

Statut actuel 

Le W3C n'est pas un organisme de normalisation officiel ; il ne peut done pretendre edi- 
ter des normes ou des standards. C'est pourquoi un document final du W3C est appele 
Recommendation, terme qui peut sembler un peu bizarre au premier abord. Mais une 
Recommendation du W3C n'a rien a voir avec un recueil de conseils, et c'est un docu- 
ment qui equivaut de fait a un standard, redige dans le style classique des specifications. 
Dans toute la suite, nous parlerons neanmoins de standards XSL ou XSLT, meme si ce ne 
sont pas des standards au sens officiel du terme. 

Le langage XSL (extensible Stylesheet Language) est un langage dont la specification 
est divisee en deux parties : 

• XSLT (XSL Transformation) est un langage de type XML qui sert a decrire les trans- 
formations d'un arbre XML en un autre arbre XML. Le standard XSLT 1.0 est une 
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W3C Recommendation du 16 novembre 1999 (voir www.w3.org/TR/xslt). A noter que les 
attributs de certains elements XML de ce langage contiennent des chaines de carac- 
teres dont la syntaxe et la semantique obeissent a un autre langage, nomme XPath (XML 
Path Language), qui n'a rien a voir avec XML, et dont le but est de decrire des ensem- 
bles de noeuds de l'arbre XML du document source a traiter. Le langage XPath 1.0 a 
fait l'objet d'une W3C Recommendation du 16 novembre 1999 (voir http://www.w3c.org/ 
TR/xpath). 

• XSLFO (XSL Formating Objects) est un langage de type XML utilise pour la descrip- 
tion de pages imprimables en haute qualite typographique. Le standard XSLFO 1 .0 est 
une W3C Recommendation du 15 octobre 2001 (voir http://www.w3c.org/TR/XSL). 

Ces deux parties s'integrent dans une chaine de production resumee a la figure 1-1. 




XSLT peut etre utilise seul, et d'ailleurs, pendant les deux ans qui ont separes la publica- 
tion des standards respectifs de XSLT et XSLFO, on ne pouvait guere faire autrement 
que d'utiliser XSLT seul. 

Inversement, il ne semble pas tres pertinent et encore moins facile d'utiliser XSLFO 
seul : la description de pages imprimables reclame des competences qui relevent plus de 
celles d'un typographe. A defaut de les posseder, il semble plus prudent de laisser la 
generation de documents XSLFO a un processeur XSLT equipe de regies de traduction 
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adequates et toutes faites, ou tout au moins d'une bi bl iotheque de regies de plus haut 
niveau quecellesqu'on pourraitecrire en partantdezero sur la comprehension des objets 
manipules par XSLFO. Une autre possibility pourrait etre d'employer un logiciel de 
transformation, qui generedu FO a parti rde documents RTF ou Latex, par exemple, mais 
on entre ici dans un domainequi n'a plus rien avoir avec I'objet dece livre. 

Commeon peutle voir sur la figure 1-1, il est possible, sous certaines conditions, d'obte- 
nirdu texte, du HTM L ou du XM L en sortiedeXSLT. En effet, bien queXSLT soittou- 
jours presente comme un langage de transformation d'arbres XML (I'arbre XML du 
document source est transforms en un autre arbre XML resultat), un processeur X SLT est 
equipe d'un serialisateur qui permet d'obtenir une representation de I'arbre resultat sous 
la forme d'une suite de caracteres. Le processus de serialisation est parametrable pour 
obtenir facilement du texte brut, du HTM L ou du XM L. Commeon peut obtenir du texte 
brut non balise au format XML, on peut done envisager de programmer des transfor- 
mations qui aboutissent a des documents RTF ou Latex, voire directement au format 
Postscript ou PDF. Mais comme les processeurs XSLFO commencent a offrir un fonc- 
tionnement stable et utilisable, ce genre de prouesse sera probablement de moins en 
moins envisagee a I'avenir. 

Une des transformations les plus courantes reste bien sur la transformation XML vers 
XHTML ou HTML, maisil ne faut pas imaginer que le langage X SLT a ete fait pour ca, 
memesi I 'allusion aux feuil les de style (stylesheet) dans le nom memed'XSL encourage 
a cette assimilation beaucoup trop reductrice : la production d'HTM L n'est qu'une pos- 
sibility parmi d'autres. 

Evolutions 

XSL est un langage qui evolue sous la pression des utilisateurs, des implementeurs de 
processeurs X SLT ou XSL-FO, et des grands editeurs de logiciels. Le role du W3C est 
entre autres de canal iser ces evolutions, afin de prendre en compte les demandes les 
plus i nteressantes, et de les el ever au rang de standard (ou W3C Recommendation). Le 
20decembre 2001, le W3C a publie des Working Drafts annoncant des evolutions 
majeures de X SLT et de X Path : W3C Working Draft XSLT2.0 et W3C Working Draft 
XPath2.0. Ces documents deboucheront a terme sur un standard XSLT 2.0 et un stan- 
dard X Path 2.0. Pour I 'instant beaucoup dechoses restenten discussion, et d'ai 1 1 eurs I'un 
des buts de ces publications est precisement de declencher les debats et les reactions, 
dont les retombees peuventeventuellementetre extremement importantes dans les choix 
final ement retenus, 

Avant \QW3C Working Draft XSLT 2.0, il y a eu un W 3C Working Draft XSLT 1.1 , qui est 
reste et restera a jamais a I'etat de Working Draft, car le groupe de travail charge de la 
redaction de la Final Recommendation s'est rendu compte que les evolutions proposees 
etaientvraiment majeures, ets'accordaientdonc mal avec un simple passage de 1.0 a 1.1. 
Les travaux de la lignee l.xx ont done ete abandonnes, et reintegres a ceux de la lignee 
2. xx. 
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Divers modes d'utilisation de XSLT 

XSLT est un langage interprets ; a cetitre il reclame un interpreter (souvent appele pro- 
cesses XSLT) qui peutetre lance de diverses facons, suivant I'objectif a atteindre. 

Mode Commande 

Le mode Commande est le mode qui consiste a lancer (a la main ou en tant que com- 
mande faisant partie d'un fichier de commandes) le processeur XSLT en lui passant les 
arguments qu'il attend (le fichier contenant la feuillede style XSLT aexecuter, le fichier 
XML atraiter, etlenom du fichier resultat, plus divers parametresou options). 

Ce mode convient pour les traitements non interactifs, et c'est d'ailleurs eel ui qui off re le 
plus de souplesse en ce sens qu'il ne requiert aucune liaison particul iere entre le fichier 
XML et la feuille de style de traitement : la mSme feuille de style peut traiter plusieurs 
fichiersXM L differents, etun memefichierX M L peutetre traite par plusieursfeuillesde 
style XSLT differentes. 

C'est aussi un mode qui n'impose aucun format de sortie particulier : on peut generer 
aussi bien du HTM L que du XM L, du Latex, etc. 

Processeurs courants 

En mode Commande, les processeurs les plus courants sontXt, Xalan, et Saxon. 

Xt est le premier processeur XSLT a etre apparu ; il a ete ecrit par un grand maitre de 
SGML et de DSSSL (('equivalent de XSLT pour SGM L), James Clark, qui est aussi 
I'editeur de la norme XSLT 1.0 du W3C. Xt n'est pas tout a fait complet, et ne le sera 
jamais, car il n'y a plus aucun developpement sur ce produit. Cependant, Xt reste 
auj ourd'hui le pi us rapide de tous I es processeurs X SLT. C 'est un produit « open source » 
gratuit (ecrit en J ava), que I 'on peut obteni r sur www.jciark.com/xmi/xt.htmi. 

Saxon est le processeur XSLT ecrit par Michael Kay, egalement auteur du premier 
manuel de reference sur le langage XSLT. C'est un produit libre et gratuit, dont les 
sources SOnt disponibles (en J ava) Sur http://saxon.sourceforge.net/. 

Pour I'avoir utilise, mon avis est qu'il est tres rapide, bien documents et tres stable. De 
plus, il est complet, et meme plus que complet, puisqu'il implemente les nouvelles fonc- 
tionnal ites annoncees dans leW3C Working Draft XSLT 1.1, et meme, a titre experimen- 
tal, eel I es annoncees dans leW3C Working Draft XSLT 2.0. 

Une version empaquetee sous forme d'un executable Windows existe aussi (Instant 
Saxon), mais n'est pas aussi rapide a I'execution que la version ordinaire. Elle est a 
consei 1 1 er uni quement a ceux qui veul ent tester Saxon sur une pi ate-forme W i ndows sans 
avoir a installer une machine virtuellej ava. 

Xalan est un processeur « open source » produit par Apache. C'est un produit libre et 
gratuit, dont les sources sont disponibles, quel'on peut I 'obteni r sur http://xmi.apache.org/ 
xalan-j/. 



Introduction 



Chapitre 1 

Comme Saxon, c'est un produit tres largement utilise par la communaute d'utilisateurs, 
done tres fiable. 1 1 est complet par rapport au standard X SLT 1.0. 

Signalons pour finir que MSXSL, le processeur XSLT de Microsoft (fourni avec 
MSXML3 ou 4), est fait pour etre lance en mode Commande, bien que les transfor- 
mations XSLT au travers du navigateur Internet Explorer soient plus popul aires. Sur les 
plates-formes Windows, il est plus rapide que Saxon. 

II y a evidemment beaucoup d'autres processeurs XSLT : on pourra, si I'on veut, faire 
son marche sur certains sites qui les recensent, comme par exemple : www.w3c.org/Style/ 
XSL, www.xmlsoftware.com/xslt, et www.xml.com/. 

Mode Navigateur 

Le mode navigateur est un mode qui ne fonctionne qu'avec un navigateur equipe d'un 
processeur XSLT (par exemple Internet Explorer 5 avec MSXML3 (ou 4), IE6 ou 
N etscape 6). A priori, ce mode de fonctionnement est typiquement fait pour que la trans- 
formation XSL aboutisse a du HTML : le serveur HTTP, en reponse a une requete, 
envoie un document XM L et la feuille de style qui genere le code HTM L adequat. Le 
gain attendu est double (voire triple) : 

• L es documents X M L qui transitent sur le reseau sont general ement moi ns bavards que 
leur equivalent HTM L : on gagnede la bande passante. 

• II arrive assez souvent que cesoit la meme feuille de style qui puisse traiter plusieurs 
documents XML differents (en provenance du meme serveur) ; dans ce cas les tech- 
niques de memoire cache sur le navigateur economisent a nouveau de la bande pas- 
sante. 

• A plus long terme, si le contenu du Web s'enrichit progressivement de documents 
de plus en plus souvent XML et de moins en moins souvent HTM L, les moteurs de 
recherche auront moins de mal a selectionner de I 'information plus pertinente, parce 
que X M L est beaucoup plus tourne vers I 'expression de la semantique du contenu que 
nel'estHTML. 

N'oublions pas non plus que la transformation XSLT sur le poste client decrott de fagon 
notable la charge du serveur en termes de CPU et de memoire consommee : moins de 
bande passante reseau utilisee et moins de ressources consommees sur le serveur sont les 
gains theoriques que I'on peut attendre de ce mode de fonctionnement. M ais bien sur, il 
faudra du temps pour que tout cela devienne courant : pour I'instant I 'evolution vers le 
traitement local de pages X M L ne fait que commencer. 

Processeurs courants 

En mode Navigateur, il n'y a guere que IE5 ou IE6 de M icrosoft qui soient vraiment 
aboutis pour les transformations XSLT (bien que Netscape 6 soit depuis peu un concur- 
rent dans ce domaine). A noter que IE5 necessite une installation auxiliaire, celle de 
MSXML3 (ou 4), qui offre une bonne implementation deXSLT 1.0. On peutobtenir 
MSXML3ouMSXML4sur http://msdn.microsoft.com/xml. 
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Netscape 6 est une alternative interessante pour XSLT. II peut y avoir encore quelques 
problemes d'appli cation de feuilles CSS au resultat obtenu, mais les evolutions sont 
rapides en ce moment: il faut consulter le site www.moziiia.org/projects/xsit pour avoir 
information la plus a jour. 

Mode Serveur 

Dans le mode serveur, le processeur XSLT est charge en tant que thread (processus 
leger), etil peut etre invoque par uneAPI Java adequate (generalementl'A PI TrAX) pour 
generer des pages HTML (ou PDF) a la volee. Typiquement, le serveur HTTP recoit 
une requete, et uneservletou unepageASP va chercher une page X M L (qui contient une 
reference a la feuille de style XSLT a charger). Cette page XM L est transmise au thread 
XSLT qui va la transformer en HTM L, en utilisant au passage des donnees annexes (par 
exemple le resultat d'une requete SQL). U ne autre possibility est que le resultat du traite- 
ment de la requete soit un ensemble d'objets (J ava, par exemple) qui resument la reponse 
a envoyer au cl ient. Cet ensemble d'objets J ava peut alors servir de base a la construction 
d'un arbre DOM representant un document XM L virtuel qui sera lui memetransmis au 
thread X SLT pour etre transforms en HTM L et renvoye vers le client. 

Ce genre de solution fonctionne tres bien, mais a tendance a consommer des ressources 
sur I e serveur. II est certain que dans I 'ideal, il vaudrait mieux demander au clientdefaire 
lui-meme la transformation XSLT, mais ce n'est pas possible actuellement, a cause de la 
grande disparity des navigateurs vis-a-vis du support de XSLT 1.0 

M erne avec IE5, il faut installer le module M SXM L3 pour que cela fonctionne, sinon le 
dialecteXSL integre par defaut a IE5 esttellementeloigne deXSLT 1.0, qu'on peut dire 
que ce n'est pas le meme langage. 

Actuellement la seule solution viable est done la transformation sur I e serveur, parceque 
e'est la seule qui permet de s'affranchir de la diversity des navigateurs ; il n'y a que si 
I'on travaille dans un environnement intranet, ou les postes clients sont configures de 
facon centralisee, que I'on peutenvisager dediffuser sur lereseau du XM L a transformer 
a I'arrivee. 

Processeurs courants 

L'API TrAX (Transformation API for XML) est uneAPI qui permet de lancer des trans- 
formations XSLT au travers d'appels de methodesjava standard. JAXP (Java API for 
XML Processing), de Sun M icrosystems, est uneAPI complete pour tout ce qui esttrai- 
tement XM L, et comporte une partie « transformation » conforme aux specifications de 
TrAX. Les processeurs dont i I est question ci-dessous implemented I 'A PI TrAX. 

En mode Serveur, on retrouve les deux processeurs Saxon etXalan, qui peuventtous les 
deux etre appeles depuis une application J ava, via des appelsTrA X , et notamment depuis 
une servlet. Cocoon, produit par Apache, est un framework integrant, grosso modo, un 
serveur HTTP, un moteur de servlets, etun processeur XSLT (Xalan). 
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Typologie des utilisations d'XSL 

II y a au moinstrois grands domaines oil lelangageXSL peut intervenir : 

• dans I es applications Internet ; 

• dans les applications documentaires ; 

• dans les applications d'echanges d'informations entre systemes heterogenes et repartis. 

La figure 1-2 montre une possible architecture d'application Internet, avec les divers 
endroits oil XSL peut (eventuellement) intervenir. Actuellement, la tendance est plutot 
d'utiliser XSL pour generer des pages HTML dynamiques, mais ce n'est qu'une ten- 
dance, et de nombreuses applications ont ete construites sur des architectures utilisant 
XSLT defacon plus importante : il serait tout a fait possible d'i magi ner une architecture 
dans laquelle les objets metier de I 'application Internet sont connected a des gisements de 
donnees repartis (par exemple via J DBC), cette connexion se faisant par I 'intermediate 
d'objets DOM (Document Object Model) qui sont adaptes et transformed par un ou 
plusieurs processus XSLT. 

Note 

La connexion via JDBC a une base de donnees est une possibility mais ce n'est pas la seule, car il y a des 
extensions, notamment avec Xalan et Saxon, qui permettent a une feuille de style de se connecter directement 
a une base de donnees relationnelle. 
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Figure 1-2 

Divers emplois d 'XSLT dans une application Internet. 
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Les applications documentaires recouvrent un vaste champ d'applications qui nefont pas 
forcement partie du domaine strictement informatique ; citons par exemple le domaine 
de la I itterature et les sciences humaines, avec des projets comme laTEl (Text Encoding 
Initiative, www.tei-c.org) ou eel ui de la composition electronique (PDF, Postscript) de 
textes anciens ou modernes dans des langues peu communes (grec ancien, arabe ancien, 
Sanscrit, copte, ecriture hieroglyphique, etc.) : voir par exemple www.fiuxus-virus.com/fr/ 
what-critical.html . 

Dans un domaine plus familier aux informaticiens, XSL intervient dans les chaines de 
production plus ou moins automatisee de documentations techniques ou commercial es et 
marketing ; un exemple simple etant la production d'un document desynthese a parti r de 
donnees au format XML extraites d'une base de donnees, qui sont ensuite mises en 
forme par XSLT etXSL-FO, etdonnentau final un document PDF ou Postscript (voir la 
figure 1-1 , a la section Le langage XSL, page 2). 

II faut citer aussi DocBook (http://docbook.sourceforge.nef), dont on reparlera d'ailleurs 
dans la suite de ce livre, qui est un systeme complet et gratuit pour rediger de la docu- 
mentation (rapports, articles, livres, documents structures, etc.) au format XML. 
DocBook delivre des sorties en HTM L (previsualisation) ou en FO, que I 'on transforme 
ensuite en PDF, par exemple (cette derniere transformation sefaisantgracea un proces- 
seurFO comme FOP, XEP ouRenderX). 

Enfin, I e domaine de I'echange de donnees entre systemes heterogenes et repartis concerne 
plusieurs courants d'activite, notammentcelui del'EDI (Electronic Data Interchange, ou 
echangede donnees informati sees), del'EAl (E nterprise A ppl ication Integration), etdes 
Web Services (www. w3.org/TR/wsdl, www.w3.org/TR/soap12-part1, www.xmlbus.com). 

Dans tous les cas, de I'information est echangee au format XM L, etdes transformations 
XSLT permettent d'adapter les donnees propres a un systeme pour les conformer a une 
sy ntaxe (DT D , X M L schemas, etc.) a I aquel I e adhere une certai ne communaute d' uti I i sa- 
teurs. 
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Donner un apercu du langageXSLT n'estpasdu toutevident. Pour un langage commeC 
ou Java, e'est assez facile de donner quelques exemples donnant une premiere impres- 
sion, parce que ce sont des langages qui ressemblent a d'autres : on peut done proceder 
par comparaison en montrant par exemple un programmeVisual Basic et son equivalent 
en Java, ou un programme Pascal et son equivalent en C. Pour XSLT, il n'y a aucun lan- 
gage un tant soit peu equivalent eta peu pres bien connu qui permette d'etablir une com- 
paraison. Seuls des langages fonctionnels ou declaratifs comme Prolog, Caml ou Lisp 
donnent une bonne base de depart qui permet de s'y retrouver, mais encore faut-il en 
avoir I 'experience... 

Si on ne I'a pas, il n'est guere possible desefier a son intuition pour deviner I'effet d'un 
programme, notamment au tout debut de la prise de contact avec ce langage. 1 1 y a nean- 
moins un angle d'attaque, qui ne donne pas un panorama complet du langage, loin s'en 
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faut, mais qui permet au moins de voir certains aspects, et de comprendre dans quelles 
directions il faut partir pour comprendre ce qu'il y a a comprendre dans ce langage. 

Nous allons done commencer par voir ce qu'on appelle une feuille de style simplifiee 
(Simplified Stylesheet) ou Litteral Result Element As Stylesheet, comme I'appelle fort 
doctement la specification XSLT 1.0. 

L'avantage est qu'une feuille de style simplifiee utilise une version tellement bridee du 
langage X SLT que I 'on peut assez facilement deviner ce que fait une tel le feui lie de style 
sans quedes explications tres detaillees soi enforcement necessaires. 

M ais I'inconvenient est que Ton ne peut pas faire grand chose de plus que ce qu'on va 
montrer dans cet apercu. 

Remarque 

Une feuille de style simplifiee n'est jamais necessaire : il n'y a jamais rien ici que Ton ne puisse faire avec une 
vraie feuille de style. 

U ne feui lie de style simplifiee peut rendre service aux auteurs de pages HTML possedant 
peu de competences en programmation, dans la mesureoii cela leur permet d'ecrire assez 
facilement des pages dynamiques. La seule contrainte a respecter absolument, qui 
contredit peut etre la pratique courante, est que le document HTM L a ecrire doit respec- 
ter la syntaxe XML, e'est-a-dire qu'il faut employer du X HTM L : toute balise ouverte 
doit etre refermee, et les valeurs d'attributs doivent etre enfermees dans des apostrophes 
ou des guillemets. 

Avant de passer a I 'exemple proprement dit, insistons encore une fois sur le fait que cette 
notion de feuille de style simplifiee n'est presentee ici que pour vous donner une pre- 
miereideedu langageXSLT. II n'y a aucune autre justification a son usage, etplusjamais 
nous n'en reparlerons dans la suite de ce livre. A utant dire qu'une feuille de style simpli- 
fiee n'a pas grand interet dans la pratique... 

Exemple 

Pour montrer comment generer une page dynamique avec une feuille de style simplifiee, 
nous al Ions prendre un exemple, et supposer que nous voulons obteni r une page telle que 
eel le qui estmontreealafigurel-3. 

Cette page est produite a partir d'un fond qui comporte essentiellement de I'HTML 
XMLise : 

AnnonceConcert.xsl 

<?xml version="1.0"?> 

<html xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" xsl :version="1.0"> 
<head> 

<title>Les "Concerts Anacreon"</title> 



Figure 1-3 

Une page HTML 
a gene re r 
dynamiquement. 
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3l Les «Concerts Anacreon> - Microsoft Internet Explorer 



□JxJ 



Fichiei Edition Atfichage Favoris Outils 



Les «Concerts Anacreon» presentent 
Concert le Jeudi 17 Janvier 2002 20H30 

ChapeUe des Ursules 

Ensemble «A deux violes esgales» 

J onathan Dunf ord , Basse deviole 
Sylvia Abramowicz , Basse de viole 
Benjamin Penot, Theorbe 
Freddy Eichelberger , Clavecin 

Oeuvres de M. Marais, D. Castello, F. Rognoni 



</head> 
<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 



<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of select="/Annonce/Lieu"/> 
</H4> 

<H2 align="center"> 

Ensemble "<xsl :value-of sel ect="/Annonce/Ensembl e"/>" 
</H2> 



<xsl :for-each sel ect="/Annonce/Interprete"> 
<P> 



Introduction 

Chapitre 1 

<xsl :value-of select=" ./Nom"/>, 

<xsl :value-of sel ect=" . /Instrument"/> 

</p> 
</xsl :for-each> 

<H3> 

Oeuvres de <xsl : val ue-of select="/Annonce/Compositeurs"/> 
</H3> 

</body> 
</html> 

Ce fichier HTML est en real ite un fichier XM L, commelemontrela premiere I igne, dont 
I 'element racine est I 'element <htmi>, qui introduit done un document HTM L. Les deux 
attributs accompagnant cet element sont obligatoires : si vous voulez ecrire votre propre 
exemple, vous pouvez recopier les deux premieres I ignes telles quel les, sans vous poser 
de question. Le premier attri but est en fait une definition de domaine nominal, e'est-a- 
dire la definition d'un jeu devocabulaire identi fie par une URL ad hoc, et abregeesous la 
forme d'un prefixe qui est ici xsi. Cette URL n'est pas du tout utilisee en tant qu'URL, 
e'est juste une chaine de caracteres convenue qui represente symbol iquement lejeu de 
vocabulaire XSLT ; cette chaine de caracteres en forme d'URL a ete determinee par le 
W3C, et le processeur XSLT qui va lire ce fichier ne prend en compteen tant qu'instruc- 
tion XSLT que les elements XM L dont le prefixe reference cette URL. II est done abso- 
lument impossible de changer quoi que cesoit a cette declaration de domaine nominal. II 
en est dememe pour I 'attri but xsi version, du moins tant que la specification XSLT 2.0 
ne sera pas parvenue au stade de Recommendation : pour I'instant, done, la seule valeur 
possible est 1.0. 

Le reste du fichier est essentiellement du XHTML, avec ca et la des instructions XSLT : 
^instruction <xsi :for-each>, et I 'instruction <xsi :vaiue-of> dans I e cas present. 

Ces instructions ont pour but d'alimenter le texte HTM L en donnees provenant d'un 
fichier XML auxiliaire. Ces donnees ne sont pas directement presentes dans le texte 
XHTM L, afin depouvoirgenerer autantde pages differentes que necessai re, ayanttoutes 
le meme aspect : il suffit pour cela d'avoir plusieurs fichiers XML differents. 

Dans notre exemple, le fichier XML auxiliaire est celui-ci : 

Annonce.xml 

<?xml version="1.0" ?> 

<Annonce> 

<Date>Jeudi 17 janvier 2002 20H30 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 



<Ensembl e>A deux violes esgales</Ensemble> 
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<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

< I nstrument>Theorbe</ Instrument 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

< Instrumental avecin</Instrument> 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 

</Annonce> 

La generation de la page HTM L dynamique consisted lancer un processeur XSLT en lui 
fournissant deux fichiers : d'une part lefichier dedonneesXM L Annonce.xmi, et d'autre 
part le fichier programme AnnonceConcert .xsi . 

Nous supposonsquenoussommesen modeCommande (voir Mode Commande, page 5), 
et que le processeur choisi est Saxon. La lignede commande pour obtenir la page HTM L 
annonce.html serait alors eel le-ci : 

Ligne de commande (d'un seul tenant) 

java -classpath saxon.jar com. icl .saxon. Stylesheet 

-o annonce.html Annonce.xmi AnnonceConcert. xsl 



Note 

Ceux qui ne voudraient pas installer une machine virtuelle Java pourraient utiliser ici Instant Saxon. 

Etle fichier obtenu serait celui-ci (voiraussi la figure 1-3) : 

Annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 
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<title>Les «Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">l_es «Concerts Anacréon» 
présentent</Hl> 
<hr><brXHl align="center"> 

Concert le Jeudi 17 janvier 2002 20H30 

</Hl> 

<H4 al ign="center">Chapel 1 e des Ursules</H4> 
<H2 al ign="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford , 

Basse de viole 

</p> 

<p> Sylvia Abramowicz , 

Basse de viole 

</p> 

<p> Benjamin Perrot , 

Théorbe 

</p> 

<p> Freddy Eichelberger , 
Clavecin 

</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 

Avantdecontinuer, il fautici faireuneremarqueimportante : le document source, malgre 
les apparences, est le fichier XML Annonce.xmi ; le processeur XSLT transforme ce 
document XM L en un document HTML annonce.html, par I 'intermedial re d'un pro- 
gramme XSLT contenu dans le fichier AnnonceConcert.xsi : le fichier auxiliaire de 
donnees est en fait, du point de vue XSLT, le document principal, et ce qui semblait 
n'etre que le modele de fichier HTM L a produire est en realite le programme XSLT a 
executer. 

Extraction individuelle (pull processing) 

Regardonsmaintenantdepluspreslefonctionnementdu programmeXSLT : il estessen- 
tiellement base sur le principede I'extraction individuelle (connu en anglais sous le nom 
de pull processing). Typiquement, le debut du programme est entierement base sur ce 
principe : 
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<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 
<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of sel ect="/Annonce/Lieu"/> 
</H4> 

<H2 align="center"> 

Ensemble "<xsl :value-of sel ect="/Annonce/Ensembl e"/>" 
</H2> 

Tout cetexte est recopietel quel parleprocesseurXSLT dans I e document HTM L resul- 
tat, a I'exception des instructions <xsi :vaiue-of> qui sontdes instructions d'extraction 
i ndi vi duel I e : dies sont done remplacees par leur valeur, valeur qui est prelevee (ou 
extraite, d'oii cette notion d'extraction i ndi vi duel I e) dans lefichier dedonneesXM L. 

Le langage XPath 

Le probleme est naturellement de definir a quel endroit du document X M L se trouve la 
donnee a extraire. C'est la qu'intervient le langage XPath, qui permet de referencer des 
ensembles d'elements, d'attributs et de textes figurant dans un document XM L. 

Par exemple, I'expression XPath /Annonce/Date selectionne tous les elements <Date> 
qui se trouvent directement rattaches a un element <Annonce> racine du document. Si 
vous regardez le document XML, vous verrez qu'il n'y en a qu'un qui reponde a la 
description. L'instruction : 

<xsl :value-of sel ect="/Annonce/Date"/> 

sera done remplacee par sa valeur, e'est-a-dire par letexte trouve dans I'element <Date> 
selectionne, a savoir : 



Jeudi 17 janvier 2002 20H30 
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Remarque 

Lanalogie entre une expression XPath telle que /Annonce/Date et un chemin Unix d'acces a un fichier a 
souvent ete soulignee. Dans notre exemple, I'expression XPath lue comme un chemin Unix voudrait dire « le 
fichier (ou repertoire) Date se trouvant dans le repertoire Annonce situe a la racine du systeme de fichiers ». 
Cette analogie est a mon avis plus dangereuse qu'utile. En effet il y a une enorme difference entre une arbores- 
cence de fichiers et une arborescence d'elements XML : il ne peut jamais y avoir deux fichiers ayant le meme 
nom dans un meme repertoire, alors qu'il peut fort bien y avoir plusieurs elements de memes noms rattaches au 
meme element. Dans notre fichier XML d'exemple, voyez comment interpreter I'expression /Annonce/Inter- 
prete : il s'agit de I'ensemble de tous les elements <Interprete> directement rattaches a la racine 
<Annonce>. Cette possible multiplicity d'elements intervient a tous les niveaux : dans une expression comme 
/Annonce/Interprete/Instrument, rien n'interdit qu'il y ait plusieurs <Interprete> par <Annonce> (deja 
vu), et plusieurs <Instrument> par <Interprete> (il n'y a pas d'exemple dans notre fichier XML, mais cela 
pourrait arriver : voir plus bas). 

La consequence, et c'est la ce qu'on voulait montrer, est qu'il est des lors impossible de lire une expression 
XPath comme on lirait un chemin Unix : c'est en cela que I'analogie est mauvaise et nocive. Un chemin Unix se 
lit normalement, de gauche a droite. Mais le meme chemin, considere comme une expression XPath, doit se lire 
a I'envers, car c'est le seul moyen de preserver la multiplicite des elements selectionnes : /Annonce/Inter- 
prete/Instrument doit se lire « les instruments qui sont rattaches a des interpretes qui sont rattaches a la 
racine Annonce ». 



En appliquant cette instruction xsi :vaiue-of aux divers chemins XPath concernes, on 
voit done facilement que le fragment de programme ci-dessus va produire le resultat 
suivant : 

<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 

<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le Jeudi 17 janvier 2002 20H30 
</Hl> 

<H4 align="center"> 

Chapel 1 e des Ursules 
</H4> 



<H2 align="center"> 

Ensemble "A deux violes esgales" 
</H2> 
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La suite du programme comporte une repetition <xsi :for-each> : 

<xsl :for-each select="/Annonce/Interprete"> 
<P> 

<xsl :value-of select="./Nom"/>, 

<xsl :value-of select=" . /Instrument"/> 

</p> 
</xsl :for-each> 

lei, instruction <xsi : for-each> selectionne un ensemble d'elements XM L contenant 
tous les <interprete> directement rattaches a la racine <Annonce> ; et dans le corps 
decette repetition, on dispose d'un element courant, qui est bien sur un <interprete>, 
que I 'on peut referencer dans une expression XPath par la notation ■ . ". Ainsi, I 'expres- 
sion Xpath "./Nom" veut dire: « tous les <Nom> rattaches directement a I 'element 
<interprete> courant ». Comme un tel <Nom> est unique, instruction : 

<xsl :value-of select="./Nom"/> 

est done remplacee par la valeur du nom de I ' i nterprete courant, etil en est dememe pour 
I 'instruction : 

<xsl :value-of select="./Instrument"/> 

Au total, cette repetition produit la sequence suivante dans le document resultat : 

<p> Jonathan Dunford , 

Basse de viole 

</p> 

<p> Sylvia Abramowicz , 

Basse de viole 

</p> 

<p> Benjamin Perrot , 

Théorbe 

</p> 

<p> Freddy Eichelberger , 
Clavecin 

</p> 

Finalement, on obtientdonc le fichier HTM L deja montre plus haut. 
Autre exemple 

Les feuilles de style simplifies se resument en gros a ce qu'on vient de voir ; il n'est 
guere possibledefaire plus, a part utiliser quelques instructions XSLT complementaires, 
par exemple un <xsi :if>. Pour illustrer ceci, supposons maintenant que I e fichier XM L 
atraiter soitconstitue ainsi : 

Annonce.xml 

<?xml version="1.0" ?> 

<Annonce> 
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<Date>Jeudi 17 janvier 2002 20H30 
</Date> 

<Lieu>Chapelle des Ursules</I_ieu> 



<Ensemble>A deux violes esgales</Ensemble> 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

< I nstrument>Theorbe</ Instrument 

< I nstrument>Luth</ Instrument 
<Instrument>Chitarrone</Instrument> 
<Instrument>Vi huel a</Instrument> 
<Instrument>Angel ique</Instrument> 

</Interprete> 



<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Cl a vecin</ Inst rumen t> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



</Annonce> 



Leproblemea traiter, ici, estqu'il peuty avoir une listed'instruments pour chaque inter- 
prete. 0 n veut que I e resul tat soi t eel ui montre a I a figure 1-4. 

Fondamentalement, il n'y a rien de change au programme. Simplement, il va falloir pla- 
cer une deuxieme instruction de repetition, pour donner la I iste des instruments par inter- 
prete, ce qui complique un peu les choses, car une liste implique la presence de 
separateurs d'elements (ici, e'est une virgule). 

Cette virgule doit apparaitre apres chaque nom d'instrument, sauf le dernier : d'oii la 
necessity d'utiliser une instruction <xsi : if> qui va nous dire si l'<instrument> courant 
est I e dernier ou non. 
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Figure 1-4 

Une page HTML un 
peu plus compliquee 
a generer 
dynamiquement. 
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Concert le Jeudi 17 Janvier 2002 
20H30 

Chapelle des Ursules 

Ensemble «A deux violes esgales» 

Jonathan Dunford (Basse de viole ) 
Sylvia Abramowicz (Basse de viole ) 

Benjamin Perrot ( Theorbe, Luth, Chitarrone, Vihuela, Angelique ) 

Freddy Eichelberger ( Clavecin ) 

Oeuvres de M. Marais, D. Castello. F. Rognoni 
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AnnonceConcert.xsl 

<?xml version="1.0" ?> 

<html xml ns:xsl ="http: //www. w3.org/1999/XSL/Transform" 
xsl :version="1.0"> 

<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 

<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of sel ect="/Annonce/l_ieu"/> 
</H4> 



<H2 align="center"> 
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Ensemble "<xsl :val ue-of select="/Annonce/Ensemble"/>" 
</H2> 

<xsl :for-each select="/Annonce/Interprete"> 
<P> 

<xsl :value-of select="./Nom"/> 

<xsl:text> ( </xsl:text> 

<xsl :for-each select="./Instrument"> 

<xsl :value-of select="."/> 

<xsl:if test="position( ) != last()"> 
<xsl:text>, </xsl:text> 

</xsl :if> 
</xsl :for-each> 
<xsl:text> ) </xsl:text> 

</p> 
</xsl :for-each> 

<H3> 

Oeuvres de <xsl :val ue-of select="/Annonce/Compositeurs"/> 
</H3> 

</body> 
</html> 

lei la premiere instruction de repetition <xsl :for-each select="/Annonce/Inter- 

prete"> selectionne un ensemble d'elements <interprete>, et chacun d'eux devient tour 
a tour l'<interprete> courant, note "." dans lesdeux premiers attributs select qui vien- 
nent ensuite : 

• seiect="./Nom" : selectionne tous les <Nom> qui sont directement rattaches a 
l'<interprete> courant (il n'y en a qu'un) ; 

• seiect=" ./instrument" : selectionne tous les <instrument> qui sont directement 
rattaches a l'<interprete> courant (il peuty en avoir plusieurs). 

La deuxieme instruction de repetition <xsi :for-each> produit done une liste d'instru- 
ments, en copiant dans le document resultat le texte associe al'<instrument> courant, et 
en lefaisant suivred'une virgule, sauf si l'<instrument> courant est I e dernier del a liste. 

Par ailleurs on remarque I'utilisation de instruction <xsi :text>. Cette instruction est 
tres utile, maisson rolerestetresmodeste, en toutcasici. E lie sert a deli miter exactement 
un texte litteral a produire dans I e document resultat, sans que des espaces, tabulations, et 
autres sauts de ligne ne viennent s'aj outer defacon intempestive au resultat. 

La difference entre : 

<xsl :val ue-of sel ect=" . /Nom"/> 
<xsl:text> ( </xsl:text> 



I 

et: 



<xsl : val ue-of sel ect=" . /Nom"/> 
( 
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est que dans le premier cas, on voit qu'il y a exactement un espace avant la parenthese, 
alors que dans le deuxieme, on voit qu'il y en a plusieurs (combien ? difficile a dire) et 
qu'il y a aussi un saut de ligne. On pourrait se passer de I'instruction <xsi : text> en 
ecrivant : 

<xsl :val ue-of sel ect=" . /Nom"/> ( <xsl : for-each select="./Instmment"> 

mais ce n'est pas tres agreable, car cela impose la presentation du programme en empe- 
chant de placer des sauts de lignes ou on veut afin d'aerer la disposition. 

Voici pour finir lefichier HTM L obtenu (on pourra comparer avec la figure 1-4), en deux 
versions: la premiere obtenue avec le programme XSLT tel qu'il apparait avant (fichier 

AnnonceConcert .xsl ) : 

annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 

<title>Les «Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">Les «Concerts Anacréon» 

présentent</Hl> 
<hr><brXHl al ign="center"> 

Concert le Jeudi 17 janvier 2002 20H30 

</Hl> 

<H4 align="center">Chapelle des Ursules</H4> 
<H2 al ign="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford ( Basse de viole ) </p> 
<p> Sylvia Abramowicz ( Basse de viole ) </p> 

<p> Benjamin Perrot ( Théorbe, Luth, Chitarrone, Vihuela, Angelique ) 
</p> 

<p> Freddy Eichelberger ( Clavecin ) </p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 
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Et la deuxieme version : 

annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 



<title>Les «Concerts Anacréon»</title> 



<H1 al ign="center">Les «Concerts Anacréon» 

présentent</Hl> 
<hr><brXHl al ign="center"> 



</H2> 

<p> Jonathan Dunford 
( 

Basse de viole 
) 

</p> 

<p> Sylvia Abramowicz 




</head> 
<body> 



Concert le Jeudi 17 janvier 2002 20H30 



</Hl> 

<H4 al ign="center">Chapel 1 e des Ursules</H4> 
<H2 al ign="center"> 



Ensemble «A deux violes esgales» 



Basse 



de viole 



</p> 

<p> Benjamin Perrot 



Théorbe 



Luth 



Chitarrone 



Vi huel a 



Angelique 



</p> 

<p> Freddy Eichelberger 



Clavecin 
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</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 

Cette deuxieme version est obtenue en supprimant les instructions <xsi :text> du pro- 
gramme precedent, comme ceci : 

<xsl :for-each sel ect="/Annonce/Interprete"> 
<P> 

<xsl :val ue-of sel ect=" . /Nom"/> 
( 

<xsl :for-each select=". /Instrument'^ 
<xsl :val ue-of select="."/> 
<xsl:if test="position( ) != last()"> 

</xsl :if> 
</xsl :for-each> 
) 

</p> 
</xsl :for-each> 

Conclusion 

Nous venonsdevoircequ'on peut fai re avec la notion de feui I le de style si mpl ifiee. Cela 
se resume a de I'extraction individuelle (pull processing), agrementee de la possibility 
d' uti I i ser quel ques i nstructi ons d'X SLT, permettant de fai re des repetitions, des tests, des 
choix multiples, et quel ques autres traitements complementaires. 

M ais il manque essentiellement le pendant de I'extraction individuelle, qui est la distri- 
bution selective (ou push processing), qui donne toute sa puissance a X SLT (mais qui en 
faitaussi la difficult^). II manque egalement des instructions qui sont i nterdites (ou plutot 
impossibles) avec les feuilles de style simplifiees, notammenttoutes les instructions dites 
de premier niveau : cela inclut la declaration de variables globales, de cles associatives 
(<xsi :key>), d'i nstructions d'importation d'autres feuilles de style, et la definition de 
model es nommes (qui sont des structures jouant a peu pres le meme role que les fonc- 
tions ou les sous programmes dans les autres langages). Avouez que cela finit par faire 
vraiment beaucoup, et que dans ces conditions, les feuilles de style simplifiees n'ont pas 
beaucoup d'interet, a part d'etre tres simples etfaciles a comprendre intuitivement. M ais 
pour quelqu'un qui connait bien XSLT, on peut aller jusqu'a dire qu'elles n'ont stricte- 
ment aucun interet par rapport aux vraies feuilles de style XSLT. 

Nousavonsvu au passage que lelangage XSLT possedeson proprejeu d'i nstructi ons, au 
format X M L, mais identifie par ledomaine nominal http://www.w3.org/1999/xsuTransform ; 
et qu'on y utilise un autre langage, le langage XPath, qui n'a rien a voir avec XML. 
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Celangage, qui permet de selectionner divers ensembles de fragments d'un document 
XM L, est en fait nettement plus complique quecequ'on a pu montrer dans les exemples 
precedents, et il faudra un gros chapitre pour en venir a bout. 

Parcours de lecture 

Nous venons de voir I'inteYet du langage XSLT, a quoi il sert et ou il se situe. Bien que 
partie integrante deXSL, XSLT est un langage qui peut etre considers comme indepen- 
dant. De plus il est extremement different, dans sa philosophie et dans les competences 
qu'il met en jeu, du langageXSL-FO, I 'autre versantdeXSL. 

C'est pourquoi dans la suite de ce livre, on se consacrera exclusivement a XSLT lui- 
meme, et a son compere X Path. 

Nous verrons done d'abord XPath, puis les principes du langage XSLT. Le style adopte 
est un style a I 'oppose d'un manuel de reference, en ce sens qu'on cherche plus afavori- 
ser la comprehension du sujet que I 'exhaustivite du propos. M ais ceci doit etre tempere 
par le fait que pi us on avancedans la lecture, et plus on en sait : on est done plus a meme 
d'accepter des details ou des subtilites vers la fin de la presentation que vers le debut. 

Si vousetes presse et voulez lire I'essentiel pour comprendreXSLT, sans entrer dans les 
details, et pour comprendre le mode de pensee a adopter pour etre en phase avec ce lan- 
gage, il n'y a qu'un chapitre a lire : le chapitre Aw cceurdu langage XSLT, page 75. 

Apres avoir fait le tour de la plus grande partie du langage en quelques chapitres, on 
s'interessera a la notion de « pattern » de conception XSLT, en mettant en evidence des 
grands themes qui reviennent frequemment, aussi bien dans le domaine microscopique 
de la programmation par des techniques parti culieres, que dans celui plus macroscopique 
de la transformation d'arbres. 

Enfin, dans les annexes, on trouvera des elements complementaires, notamment la des- 
cription sommaire de quelques instructions dont la comprehension ne pose pas de diffi- 
culte particuliere, ou dont la comprehension est plus du ressort detests effectifs avec un 
processeur XSLT que de celui d'une lecture argumentee. On y trouvera aussi des ele- 
ments syntaxiques, et une description des foncti ons predefines XPath etXSLT. 

A noter que dans ce livre, les exemples fournis ont tous ete testes avec les processeurs 
X alan et Saxon, et que le mode de foncti onnement sous-jacent des exemples proposes est 
lemodeCommande ; cela n'a aucuneinfluencesur lasemantiquedu langage XSLT, mais 
eel a permet de fixer les idees. 



Premiere Partie 



Les langages XPath 
et XSLT 




C hapitre 2. 




.... 29 


C hapitre 3. 


Au C(Kur du langageXSLT 


.... 75 


C hapitre 4. 




.... 127 


C hapitre 5. 




.... 167 


C hapitre 6. 




.... 249 


C hapitre 7. 


Decoupaged'une application XSLT 


.... 373 




Guide de lecture 

Chapitre XPath 

Le chapitre sur XPath est globalement tres important pour la comprehension du reste. 
Notamment, il est absolument indispensable d'avoir toujours present a I 'esprit le modele 
arborescent d'un document XML VU par XPath (Modele arborescent d'un document 
XML vu par XPath, page 30), car ce modele est a la base detous les raisonnements divers 
et varies en XSLT. 

L a section suivante, XPath, un langage d' expressions, page 40, peut etre ignoree en pre- 
miere lecture. Certains passages, dans la suite du livre, y font reference, et on pourra 
eventuellement attendre d'y etre invite ou d'avoir un probleme lie a I'ecriture ou la lec- 
ture d'une expression pour aller voir cette section. Dans beaucoup decas simples, I 'intui- 
tion peut suffire, au moins pour lire une expression. 

Les trois sections SUivanteS (Principes de la construction d'un chemin de localisation, 
page 47, Etape de localisation, page 48, Chemins de localisation, page 62) represented 
le cceur d'XPath : el I e sont essenti el I es pour la comprehension d'XPath et d'XSLT. 

Notamment la Section Lecture d'un chemin de localisation sans predicat, page 64, in- 

diqueun algorithme pour I ire les chemins XPath ; cela aide beaucoup au debut, quand on 
n'a pas encore I 'habitude de manipuler lesetapes de localisation. 

La Section SUivante, Formes courtes des chemins de localisation, page 68, indique I es 

abreviations standards utilisees en XPath. Cette section est egalement incontournable, 
car ces abreviations sont presque toujours utilisees dans la pratique. 

La derniere section, Variantes syntaxiques, page 70, pourra etre sautee en premiere lec- 
ture, car el I e donne des elements assez subtils, indispensables a mettre en ceuvre dans 
certains cas, mais heureusement assez rares. 

Chapitre Au cceur d'XSLT 

Ce chapitre est le chapitre essentiel pour la comprehension generale du langage XSLT. 
II s'opposefortement a I 'introduction vuea la section Un avant- gout d'XSLT, page 9, en 
ce sens que I'on ne fait pas appel ici a I'intuition, mais qu'au contraire, on demonte le 
mecanisme de traitement specifie par XSLT. Ce chapitre, une fois lu, permet la compre- 
hension globale de tout XSLT : le reste est constitue d'ajouts, defacilites, de details, etc., 
mais il n'y a aucun mecanisme fondamentalement nouveau. Seules trois instructions y 
serontvues : xsi :tempiate, xsi :vaiue-of, etxsi : appiy-tempi ates, parce qu'elles sont 
au coeur du modele de traitement, de meme que la notion de motif et de concordance de 
motif (pattern matching), qui sera vue de facon tres detaillee a cette occasion. 

Chapitres sur les instructions XSLT (transformation, programmation, creation) 

Le modele de traitement du langageXSLT etantvu, lerestedu langage consiste en divers 
ajouts (des instructions) permettant d'exploiter pleinement la puissance de ce modele de 
traitement. II est alors possible de grappiller en fonction des besoins, bien que les trois 
chapitres soient organises de telle sortequ'il n'y ait pas de references avant. Une lecture 
I i neai re est done recommandee, mais el I e n'est pas obi i gatoi re. 



Ces instructions sont classees en trois categories: transformation, programmation et 
creation. Chaque categorie correspond a un chapitre. Ces trois chapitres sont presentes 
suivant un plan assez regulier, dans lequel chaque instruction (mis a part quelques ins- 
tructions comme xsi :template, xsl :value-of, etxsl : apply-templ ates, qui neSOntpaS 
concernees parce qu'elles ont ete deja vues au chapitre Au cceur du langage XSLT, 
page 75, ou quelques autres qui sont extremement simples) sera presentee comme ceci : 

• bande-annonce; 

• syntaxe; 

• regie XSLT typique; 

• semantique; 

• exemples divers ; 

• eventuellement vari antes syntaxiques et exemples. 

La section bande-annonce donne un apercu de instruction sur un exemple simple, le 
plus souvent (mais pas toujours) repris plus loin dans la suite des explications. Cette 
bande-annonce permet de se faire rapidement une idee intuitive de instruction. 

La section syntaxe donne la forme de instruction avec les eventuelles contraintes a res- 
pecter. 

La section regie XSLT typique donne une forme de regie XSLT (xsi template) dont le 
model ede transformation emploietypiquement instruction decrite. 

La section semantique indique I'effet de instruction, c'est-a-dire la facon dont el I e est 
instanciee. 

Les exemples viennent ensuite: certains sont directs, d'autres sont I'occasion de 
quelques digressions induites par des difficultes inattendues. 

Les variantes syntaxiques introduisent generalement des possi bi I ites nouvelles offertes 
par des attributs facultatifs de instruction decrite. 

Si Ton est presse et que I'on souhaite se contenter d'une lecture de premier niveau, on 
pourra se contenter de lire la bande-annonce, la syntaxe, la regie XSLT typique, et de 
jeter un coup d'ceil a la semantique ; si I'on n'est pas presse ou que I'on revientsur cette 
instruction apres avoir bute sur une difficult^, on pourra lire la semantique plus en detail, 
et analyser les exemples qui viennent ensuite. 

Chapitre Decoupage d'une application XSLT 

Ce chapitre est un peu a part, dans la mesure ou il n'apporte aucune fonctionnalite nou- 
velle au langage XSLT, si ce n'est la facon de decouper une application XSLT, soit pour 
la rendre plus facilement maintenable, soit pour rendre reutilisables certains de ses 
constituants. C'est done plutot un chapitre donnant quelques elements de Genie Logici el 
en XSLT, qui peut evidemment etre ignore en premiere lecture si votre but est unique- 
ment, dans un premier temps, la realisation de transformations XSLT. 
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Le langage XPath 



Le langage XPath est standardise sous la forme d'une «W3C Recommendation » du 
16 novembre 1999. 

Cen'estpasun langage de la familleX M L : c'estun langage d'expression permettantde 
constituer des ensembles de nceuds provenant de I'arbre XML d'un document. XPath 
intervient dans XSLT d'une facon tellement intriquee, qu'on pourrait croire qu'il nefait 
qu'un avec XSLT. M ais en fait, c'est un langage a part, parce que le W3C en a fait une 
brique intervenant dans d'autres langages, comme par exemple XPointer (pour XSLT 
1.0) ouXQuery (pour XSLT 2.0). 

C'est un langage assez simple dans sa structure, puisqu'il se limite a des expressions, 
mais I 'interpretation de certaines expressions (complexes ou non) peut parfois etre assez 
subtile. Heureusement, dans la pratique, les expressions XPath que I'on doit manipuler 
sont generalement assez simples, eten tout cas, deviennent assez vitefamilieres. 

Pour voir comment fonctionne X Path, il faut d'abord comprendre sur quoi repose son 
fonctionnement. X path etant fait pour traiter des documents X M L, i I utilise un model ede 
representation arborescente d'un document XML, qui conditionne tout le reste; nous 
commencerons done par voir ce modele d'arbre. Ensuite, nous verrons comment chemi- 
ner dans un tel arbre, avec la notion de chemin de localisation, notion central e de X Path, 
impliquant elle-meme d'autres notions plus elementaires, telles que les axes de localisa- 
tion, les determinants, et les predicats. Ces elements sont les ingredients de base pour 
ecrire des etapes de localisation, dont I'enchainement donne des chemins de localisation 
qui peuvents' interpreter en termesd'ensemblede nceuds del 'arbre traverse : XPath spe- 
cifie comment ecrire des chemins de localisation, et comment les interpreter pour obtenir 
des ensembles de nceuds. 
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Modele arborescent d un document XML vu par XPath 

Nous allons expliquer ici comment X Path « voit » un document X M L, c'est-a-dire etu- 
dier la structure arborescente utilisee par XPath pour model iser un document XM L. Le 
modele arborescent utilise par XPath n'est pas necessairement celui qui est reellement 
implements en memoire lors de I 'execution d'un processeur XSLT ; c'est un modele 
conceptuel qui permet de fixer I es idees et d'expri mer commodement les proprietes de ce 
langage. 

L'arbre manipule par XPath n'est pas different de I'arbre XM L du document; simple- 
ment, des precisions sontapporteessur la nature de certains liens parent-enfant, ainsi que 
sur la nature des nceuds de I 'arbre. 

1 1 y a sept types de nceuds possibles dans un arbre : 

• root : le type du nceud racine de I'arbre XM L du document, a ne pas confondre avec 
I 'element racine du document, qui est un element comme un autre, a part qu'il n'a pas 
d'element parent. L'element racine fait partie du document XML, alors que la racine 
root de I 'arbre n'a pas de contrepartie visible dans le document XML. 

• element . le type d'un nceud element XML. 

<xxx> . . . </xxx> 

• text : le type d'un nceud textefaisant partie d'un element. 

... blabla ... 

• attribute : le type d'un nceud attri but d'element X M L . 

surf ace= ' 12m2 ' 

• namespace : le type d'un nceud domaine nominal permettant de qualifier les noms 
d'attributs ou d'elements intervenant dans certaines parties d'un document X M L. 

xml ns : txt="http : //www. w3c . org/xml /schemas/Basi c-text . dtd" 

• processing-instruction : le type d'un nceud processi ng-instruction (directive de 
traitement), en principe adressee a un programme autre que le processeur XSLT lui- 
meme. 

<?cible argl arg2 . . . ?> 

• comment . le type d'un nceud commentaireXM L. 

<!-- ... --> 

II est possible d'obtenir la valeur textuelle de n'importe quel nceud ; eel a semble evident 
pour un noeud de type text ou attribute, mais c'est aussi possible pour tous les autres 
types. Parfois la valeur textuelle d'un noeud ne depend que du nceud en question, mais 
parfois die depend aussi de ses descendants (cas d'un nceud de type element) ; cela 
depend en fait du type de nceud : un algorithme sera done donne pour chaque type, per- 
mettant de calculer cette valeur textuelle. 
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Nceud de type root 

Bien sur, un seul nceud peut etre de type root. A la racine sont attaches, dans un lien 
parent-enfant : I 'element raci ne du document XML proprement dit (que I 'on trouve apres 
le prologue), les instructions de traitement et les commentaires qui interviennent dans le 
prologue et apres la fin de I 'element racine du document XM L (voir la figure 2-1). 



Exempl e 

<?xml version='1.0' encodings ISO-8859-1' standalone='no' 
<!D0CTYPE passacaille SYSTEM "Danse.dtd" > 
<?play audio armide.avi?> 
<passacaille> 

</passacaille> 

<!-- fin du document --> 



?> 



Figure 2-1 

Un rueud de type 
root. 



processing 

instruction 

play audio armide.avi 




r- element 

[ passacaille 

i 
i 



comment 

fin du document 



La valeur textuelle du nceud de type root est la concatenation des valeurs textuelles de 
tous ses nceuds descendants pris dans I'ordre de lecture du document. 



Nceud de type element 

1 1 y a un nceud de type el ement pour chaque element <xxx> du document X M L . A un 
nceud detype element sont attaches, dans un lien parent-enfant : les nceuds de type ele- 
ment, enf ants directs de I 'element considers, les nceuds detype processing instruction, 
comment, et text qui font partie du contenu del 'element considers (voir la figure 2-2). 

Exempl e 

<RDC> 

<?play "QuicktimeVR" "rdc.mov" ?> 

Rez de chaussee au meme niveau que la rue, vaste et bien eclaire. 
<cuisine> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 
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<sejour> 

Cheminee en pierre. Poutres au plafond. 

Carrel age terre cuite. Grande baie vitree. 
</sejour> 
<bureau> 

Bibl iotheque encastree. 
</bureau> 
<garage/> 

<!-- pas de donnees disponibles sur le garage --> 
Dans la cour : palmier en zinc, figurant le desert 
(demontabl e) . 
</RDC> 



element 

RDC 



_ processing 
instruction 

play 
"QuickTimeVR 
"rdc.mov" 



— text — 

Rez de 
chausseeau 
meme niveau 
que la rue, 
vasteetbien 
eclaire. 




text — 

Dans la cour : 

palmier en 
zinc, figurant 

I e desert 
(demontable) 



- comment - 

pas de donnees 
disponibles sur 
le garage 



Figure 2-2 

Un nceud de type element. 



La valeur textuelle d'un nceud detype element est la concatenation des valeurs textuelles 
de tous ses descendants de type text (pas uniquement les enfants directs, mais seulement 
les nceuds text) pris dans I 'ordrede lecture du document. L'exemplequi suitconcerne le 
document montre ci-dessus : 
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valeur textuelle de <RDC> 

Rez de chaussee au meme niveau que la rue, vaste et bien eclaire. 
Evier inox. Mobilier encastre. 

Lavabo. Cumulus 200L. 

Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande baie vitree. 

Bibl iotheque encastree. 

Dans la cour : palmier en zinc, figurant le desert 
(demontable) . 



Cette valeur textuelle comporte beaucoup de lignes blanches, et nous verrons pourquoi 
un peu plus loin. 

Nceud de type attribute 

Chaque nceud de type element possede un ensemble associe de nceuds de type attri- 
bute. Ces nceuds detype attribute sont attaches au nceud element considers par un lien 
special : I 'element est parent des nceuds attributs, mais les nceuds attributs ne sont pas 
enfants de leur parent. En d'autres termes, I 'ensemble des enfants d'un element ne 
contient pas ses attributs, mais pourtant, chaque attri but a un parent, qui est I 'element 
pour lequel I'attribut est defini. Un nceud attri but n'a pas d'enfant. Si I 'attri but sert a 
declarer un domaine nominal, ce n'est pas un nceud detype attribute qui est cree, mais 
un nceud detype namespace. L a figure 2-3 montreun exemplede nceud attribute. 



Figure 2-3 

Un nasud de type 
attribute. 




a pour parent 
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Exempl e 

<cuisine surface='12m2'> 

</cuisine> 

La valeur textuel I e d'un nceud de type attribute est tout simplement la valeur de cet 
attri but. 

Nceud de type namespace 

Chaque element possedeun ensemble dedomaines nominaux utilisables (mais pasforce- 
ment utilises) : ce sont les domaines nominaux declares par cet element ou I'un de ses 
ancetres, et non redefinis entre-temps le long de la hierarchie. Un nceud de type name- 
space est cree, pour chaque element, et pour chaque domaine nominal visible. Comme 
pour un nceud de type attribute, I 'element est le parent du nceud de type namespace 
ainsi cree, mais pourtant ne le possede pas en tant qu' enfant : voir la figure 2-4. 





element 



a pour parent 



namespace 

http://www.w3c.org/xml/schemas/Basic-text.dtd 




element 

alinea 



a pour parent 




a pour parent 



namespace 

http://www.w3c.org/xml/schemas/Basic-text.dtd 



namespace 

http://www.duralex.fr/salaries/cdd.html 



Figure 2-4 

Des neeuds de type namespace. 



Exempl e 

Oesume xml ns=" http: //www. w3c. org/xml /schemas /Basic- text. dtd" > 



<jur:alinea numero="12.2.3.5" 
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xml ns : jur="http: //www. dura 1 ex.f r/sal aries/cdd. html "> 

<texte> 

<al inea> 

<al inea> 
<texte> 
</jur:al inea> 

</resume> 

La valeur textuel I e d'un noeud de type namespace est tout simplement la valeur de ce 
domaine nominal. 



Nceud de type processing-instruction 

Un noeud de type processi ng-i nstructi on est cree pour chaque instruction de traite- 
ment, sauf si el I e i ntervi ent a I ' i nteri eur del a partie DTD du document. Un noeud detype 
processing-instruction n'a pas d'enfant : voi r la figure 2-5. 

Exemple 

<passacaille> 

<?play audio armide.avi?> 

</passacaille> 



Figure 2-5 

Un n«>ud detype 

processing 

instruction. 



r- element 

[ passacaille 



processing 
instruction 



play audio armide.avi 



La valeur textuel I e d'un noeud de type processing-instruction est la chaine de carac- 
teres comprise entre le nom de I'instruction (exclu) et le ?> final (exclu). Dans notre 

exemple, Ce Serait done audio armide.avi. 

Nceud de type comment 

Un noeud detype comment est cree pour chaque commentai re, sauf s'il i ntervi ent a I 'i nte- 
ri eur de la partie DTD du document. Un noeud detype comment n'a pas d'enfant : voir la 
figure 2-6. 
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Exempl e 

<passacaille> 
<!-- debut de 



la passacaille --> 



</passacai 1 1 e> 



Figure 2 ' 6 r element 

Unn^ud detype passacaille 
comment. v — r- 

comment 

debut de la passacaille 



La valeur textuelle d'un nceud detype comment est la chaine de caracteres comprise entre 
le debut et la fin du commentaire ( <!-- et -->exclus) . Dans notre exemple, ce serait 

done debut de la passacaille. 



Nceud de type text 

Chaque nceud detype element peut avoir des nceuds enfants detype text. II n'y ajamais 
deux nceuds de type text cote a cote parmi les enfants du nceud ei ement parent, car un 
nceud text esttoujourscree d'un seul tenant, de telle sorte que le nombre total de nceuds 
text enfants du nceud element considere soit minimal, et que la taille de chacun d'eux 
soit maximal. Un nceud detype text n'a pas d'enfant : voir la figure 2-7. 

Exempl e 

<xxx> 

blabla 

<yyy> • ■ ■ </yyy> 

suite du blabla 

</xxx> 



Figure 2-7 

Deux n«?uds de type 
text. 



element 

XXX 
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En general, la representation arborescented'un document XM L necontenantpasdetexte 
apparent comporte tout de meme des nceuds text (II suffit pour cela que le document 
XML soit indente pour en ameliorer la lisibilite) : 

<xxx> 
<yyy> 

<zzz a="12'7> 

</yyy> 

</xxx> 

Dans ce document X M L, il y a des sauts de lignes (puisqu'il y a manifestementplusieurs 
lignes) et des tabulations ou des espaces (puisque les lignes sont manifestement inden- 
tees). Ces caracteres (saut de ligne, espace, tabulation) sont connus sous I'appellation 
generique d'espaces blancs (white space en anglais) ; ces espaces blancs etant des carac- 
teres, ils donnent, comme les autres, naissance a des nceuds text (voir figure 2-8). 



Figure 2-8 

Des na?uds de type 
text qu 'on 
n'attendait pas. 



element 

XXX 




a pour parent 



attribute 

a="12" 



Dans la figure 2-7, le premier nceud text contient done plus que caracteres qu'il n'y 
parait : saut de ligne, tabulation, blabla, saut de ligne, tabulation. C'est pour la meme rai- 
son que la valeur textuellede I'element <rdc> montre a la section Naud de type element, 
page 31 est parseme de lignes blanches. 

La valeur textuelle d'un nceud de type text est tout simplement la valeur de ce texte. 
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Exemple d'arbre XML d'un document 

On prend ici comme exemple un document XM L de description d'une maison (dans le 
style agence immobiliere), et on montrel'arbreXM L correspondant, tel qu'il sera mani- 
pule par X Path (voir figure 2-9) : 

Maison.xml 

<maison> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 

Bibliotheque encastree. 
</bureau> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

Palmier en zinc figurant le desert 
</terrasse> 

<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='l'> 
Lambris. 

</al cove> 
</chambre> 

<chambre surface='18m2'> 

Lambris. 
</chambre> 

<sal leDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 



Note 

Sur la figure 2-9, les espaces blancs ne sont pas mis en evidence, et les nceuds texte ne contenant que des 
espaces blancs ne sont pas montres, afin de ne pas trop compliquer la figure. Ces nceuds « a blanc » sont 
en general inutilises et souvent inoffensifs ; en deuxieme lecture, on pourra se reporter a instruction 
<xsi : strip-space> pour une analyse de ce probleme. 
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XPath, un langage d'expressions 

Note 

Cette section peut etre ignoree en premiere lecture 



Xpath est un langage d'expressions. Cela signifie que dans ce langage, a part I 'expres- 
sion, il n'existe aucune autre construction syntaxique. Sans etre complique, le langage 
n'est pourtant pas d'une simplicity extreme, et il peut arriver, de temps a autre, que I'on 
soitderoute par une subti I ite inattendue. 

En X Path, on peut manipuler quatre types d'objets : les ensembles de nceuds (type node- 
set, c'est-a-dire une col lection non ordonnee sans repetition de nceuds d'arbreXM L), les 
booleens (type boolean), les nombres reels (type number), les chaines de caracteres (type 
string). Les types boolean, number et string sont cequ'on appelle des types simples. 

Par ailleurs, on dispose d'operateurs, mais il n'y a pas plethore : dans le genre minima- 
liste, c'estassez reussi. 

Enfin, on dispose de fonctions predefines, qui renvoi ent des valeurs de I'un des quatre 
types possibles, de variables, qui apparaissentsous la forme d'un nom precede d'un dol- 
lar (ex : SprixAuKilo), et de Valeurs litteraleS (ex : true, 12, 12.5, 'Bonjour Madame, 

eta-t-n son chapeau. '). II n'y a pas de valeurs I itterales detype node-set. 

Avec tout cela, on peut former des expressions. M ais il n'est pas tres simple d'etudier 
comment, parce qu'il n'est pas evident de trouver par quel bout prendre la chose ; une 
lecture fidele du standard X Path aurait vite fait de nous entrainer dans des contrees etran- 
ges ou I'on definit des choses aussi incroyables qu'un test d'inferiorite entre un node-set 
et un booleen. 



Note 

II ne faudrait pas croire pour autant que le standard XPath est un document loufoque : si ces comparaisons 
extraordinaires sont possibles, c'est parce qu'il existe des fonctions de conversions et des algorithmes d'interpre- 
tation des expressions mixtes, et que ces fonctions et algorithmes couvrent tous les cas utiles ; et de fait, dans la 
pratique, il peut etre indispensable de pouvoir convertir un node-set en booleen. A partir de la, plus rien ne peut 
I'empecher de le comparer a un autre booleen, meme si ce n'est pas forcement tres utile. 



Pour eviter detomber dans ce genre detrou noir, nous allons faire un peu de slalom dans 
la grammai re XPath : nous verrons d'abord des expressions ne comportant aucun argu- 
ment de type node-set, puis des expressions ne comportant que des arguments de type 
node- set, puis nousevoquerons les expressions mixtes, en evitantde nous perdre dans les 
details. En annexe, on trouvera la description des fonctions deconversions a utiliser. 

Enfin, et c'est la qu'on voulait en venir, nous arriverons au type principal d'expression 
XPath, lechemin de localisation, qui nous occupera jusqu'a la fin dece chapitre. 
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Note 

En premiere lecture, il n'est pas utile de suivre lineairement les prochaines sections. Vous pouvez sauter directe- 
ment a la section Expressions mixtes, page 45, dans lequel vous pourrez vous contenter de lire ce qui concerne 
la comparaison d'un node-set et d'un booleen, ainsi que celle d'un node-set et d'une string. Ensuite, vous pour- 
rez reprendre une lecture normale a partir de la section Principes de la construction d'un chemin de localisation, 
page 47. 

Les sections sautees pourront etre consultees ulterieurement, en cas de besoin, ou a titre de curiosite, pour 
completer vos idees et vos connaissances sur les expressions XPath. 



Expressions sans argument de type node-set 
Expressions numeriques 

Ce sont des expressions qui manipulent des nombres, c'est-a-dire des objets de type 
number. Ces nombres sont des nombres fractionnaires en double precision, conformes 
a la norme IEEE 754. Cette norme definit entre autres une valeur NaN (Not a Number) 
que I'on obtient par exemple dans la division de 0 par 0, mais aussi un infini positif 

(infinity) et un infini negatif (-Infinity). 

Les nombres peuvent etre compares par les operateurs = <= >= ! = qui ont leur significa- 
tion habituelle. 

Pour les calculs, on dispose de I'operateur « moins» unaire (-5.8, par exemple) et des 
cinq operateurs binai res classiques : + - * div mod (addition, soustraction, multiplica- 
tion, division, reste de la division entiere). Ajoutons a cela trois (excusez du peu) fonc- 
tions mathematiques predefinies : floor (plus grand entier inferieur), ceiling (plus petit 
entier superieur) et round (plus proche entier). 

II n'y a rien d'autre, memepas defonction puissance ou racinecarree. 

Exemple d'expressions numeriques 

$b * 100 + $d - 4800 + floor($m div 10) 

$J + 31741 - ($J mod 7)) mod 146097 mod 36524 mod 1461 

(($d4 - $L) mod 365) + $L 

Expressions a base de chaines de caracteres 

Les valeurs litterales de chaines de caracteres sont des sequences de caracteres entre 
apostrophes doubles (") ou entre apostrophes simples (■), comme on veut. 

On peut tester I 'egalite dedeux chaines (operateurs = ou !=) mais on ne peut pas les clas- 
ser : les operateurs < ou > provoquent une conversion de leurs arguments en nombres. La 
seule maniere, a la rigueur envisageable, de classer deux chaines dans I'ordre alphanu- 
merique, seraitd'uti User I 'instruction detri proprea XSLT. 

On dispose de quelques fonctions predefinies de traitement de chaines : 

• string-i ength, pour renvoyer le nombre de caracteres de la chaine ; 

• concat, pour concatener deux chaines en une seule (c'est-a-dire les mettrebouta bout) ; 
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• normal ize-space, pour supprimer tous les espaces blancs en tete, tous les espaces 
blancs en fin, et remplacer toute autre sequence interne d'espaces blancs par un seul 
espace ; 

• translate, pour remplacer certains caracteres par d'autres ; 

• substring, pour extrai re une sous-chaine ; 

• contains, pour tester la presence d'une sous-chaine dans une chaine ; 

• starts-with, pour tester la presence d'une sous-chaine au debut d'une chaine; 

• substring-after, pour rechercher une sous-chaine et extraire la sous-chaine situee 
apres ; 

• substring-before, pour rechercher une sous-chaine et extraire la sous-chaine situee 
avant. 

La fonction ends-with n'existe pas. 
Expressions booleennes 

II n'y a pas de valeurs litterales commetrue ou false pour representer les deux booleens 
possibles. Ces deux valeurs sont donnees par deux fonctions sans argument : true( ) et 

falseO. 

Pour operer des calculs booleens, on ne dispose que de deux operateurs, or et and, et 
d'une fonction predefinie, note ), qui renvoie la negation de son argument. 

Exemple d' expression booleenne 

($somme < 3000) and (Sdevise = 'Franc') and ($fini or not( Strouve)) 

Les operateurs de comparai son < ><=>== != sont utilisables avec les booleens. Les 
operateurs = et != ont le sens habituel ; les operateurs d'inegalite provoquent une 
conversion prealable des booleens en nombres, avec la convention true donne 1 et false 
donne 0 ; ensuite on compare les nombres. N otez que si $a et $b sont deux booleens, $a 
<= $b signifie "$a impiique $b" (en effet, "$a impiique $b" n'est faux que si $aestvrai 
et $b est faux, ce qui est compatible avec une comparaison des nombres 0 et 1, d'apres la 
convention indiquee). 

Expressions avec arguments de type node-set 

Un node-set, nous I'avons deja dit, est un ensemble de nceuds provenant d'une source 
XM L, et plus precisement de la representation sous forme d'arbreXM L de cette source. 
Qu'un element appartienne a un node-set n'implique pas que sa descendance en fasse 
necessairement partie: par exemple, on peut tres bien avoir un node-set ne contenant 
qu'un seul element, a savoir I 'element racine du document, sans que pour autant, tout le 
document se retrouve dans le node-set. 

Un node-set est un ensemble au sens mathematique du terme: une collection non 
ordonnee de nceuds d'arbreXM L, sans doublon. 
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II n'y a qu'un seul operateur ensembliste : I'operateur - 1 ■ (la barre vertical e), qui repre- 
sente I 'union ensembliste. II esttoutefois possible d'ecrire une expression, pas tres com- 
pliquee en termes de nombre de caracteres, mais tres difficile a imaginer quand on ne 
connait pas la solution, qui donne I 'intersection de deux node-sets. 

Note 

C'est d'ailleurs si peu evident a trouver que les concepteurs du standard XPath etaient loin d'imaginer que 
c'etait faisable lorsque le standard est paru dans sa version definitive, en 1 999. En fait, il a fallu attendre I'annee 
2000 pour que quelqu'un (Michael Kay, en I'occurrence) decouvre cette fameuse expression, que voici : 
$p[count (. |$q) = countrjq)], qui donne I'intersection des deux node-sets $p et $q. II n'est pas possible 
d'expliquer des maintenant pourquoi le resultat obtenu est le bon, car il faut attendre d'avoir vu la notion de predi- 
cat, qui est ici utilisee, ainsi que celle de nceud contexte (le point, juste avant la barre verticale). 

II n'y a pas non plusd'operateur ou defonction predefinie permettant de tester I' apparte- 
nance d'un noeud a un node-set (si non il aurait ete trivial de construire une expression 
donnant I'intersection), ou I'inclusion d'un node-set dans un autre. Par contre, on a une 
fonction predefinie, count ( ), qui renvoiele nombre d'elementsdu node-set donne, cequi 
permet (entre autres) de tester si un node-set est vide. 

Les choses amusantes arrivent maintenant. II est possible, grace aux operateurs = et \=, 
de comparer des node-sets. Les regies de comparaison sont a premiere vue assez cu- 
rieuses, eten toutcas, ont des consequences assez etonnantes, comme par exemple cell e- 
ci : si $p est un node-set, alors $p = $p n'est pas une expression toujours vraie. 

Remarque 

Avant de voir ceci plus en detail, demandons-nous pourquoi aller chercher des regies diaboliques qui parsement 
la route de chausse-trappes, au lieu de mettre en place de regies classiques qui seraient intuitivement evi- 
dentes ? A nouveau, il ne faut pas imaginer que le standard XPath est un document loufoque, pratiquant 
I'humour par I'absurde. En fait ces regies sont bizarres quand on les examine en dehors de leur contexte, et 
qu'on les replace dans le contexte general (mathematique) de manipulation d'ensembles. Mais ce n'est pas 
dans ce contexte-la que ces expressions sont employees ; ces regies sont faites pour ecrire des predicats de 
fagon concise. II est encore trap tot pour expliquer exactement ce qu'est un predicat, mais disons en gros qu'un 
predicat est une expression booleenne qui permet de filtrer un node-set pour eliminer les indesirables, a savoir 
les noeuds qui ne verifient pas le predicat. C'est done a la lumiere de la facilite d'ecriture de predicats qu'il faut 
eclairer les regies de comparaison de node-set, et non a la lumiere des mathematiques standard. En cherchant 
a optimiser au mieux I'ecriture de certains types de predicats qui reviennent souvent dans la pratique, on arrive 
a des choses qui peuvent donner froid dans le dos au premier abord, mais qui finalement se revelent tres effi- 
caces a I'usage, quand on ecrit des predicats. Le seul probleme est que les comparaisons de node-sets peuvent 
intervenir ailleurs que dans des predicats, par exemple dans des tests, avec I'instruction XSLT <xsi :lf . . .>. 
C'est la qu'on peut deraper, parce qu'on n'est plus dans le domaine privilegie des predicats, et que Ton doit etre 
conscient des pieges que constituent ces regies vis-a-vis de la logique habituelle. 



Comparaison de deux node-sets avec I'operateur = 

Si $p et $q sont deux node-sets, alors $p = $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un noeud ni et dans $q un noeud N2 qui ont meme 
valeur textuelle. 
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Cette definition repose sur la valeur textuelle d'un nceud, qui a ete definie a la section 
M od<?le arborescent d'un documentXML vu parXPath, page 30. 

On voit tout de suite qu'il faut pouvoirtrouverau moins un nceud danschacun des node- 
sets pour que I'egalite ait une chance d'etre vraie ; il en resulte immediatement que deux 
node-sets vi des ne sont pas egaux, et meme pi re, que $p = $pestfauxsi $pestvide. 

Un autre point a prendre en compte, est que la valeur textuelle d'un noeud ne reflete peut- 
etre pas total ement toutes les proprietes visibles de ce noeud. 

Par exemple, SUppOSOnS que $p COntienne I'element <animal hauteur="3m">gi raf e</ani - 
mal >, et $q I'element <animal hauteur="5m">gi raf e</ani mal > ; alors I 'egalite $p = $q 

est vraie. En effet, les attributs nefont pas partiede la valeur textuelle d'un element : les 
deux elements ci-dessus ont done meme valeur textuelle, ce qui suffit a donner I'egalite. 

Comparaison de deux node-sets avec I'operateur != 

Si $p et $q sont deux node-sets, alors $p != $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un noeud ni et dans $q un noeud N2 qui ont des 
valeurs textuel les differentes. 

D'apreslesdeuxdefinitionsquel'onvientdevoir, il estimmediatque: not( $p = $q ) 
et ( $p i= $q ) sont deux expressions differentes, qui ne donnent pas en general le 
meme resultat. II en est de meme avec note $p \= $q ) et ( $p = $q ) . 

L'expression note $p = $q ) est vraie quand les deux node-sets ont des valeurs tex- 
tuelles toutes differentes deux a deux. De meme, I'expression note $p i= $q )estvraie 
quand les deux node-sets ont des valeurs textuel les toutes identiques deux a deux. 

Notez bien encore une fois que les comparaisons reposent sur des comparaisons de 
valeurs textuelles ; il n'est pas question ici d'identite : revoyez ci-dessus I'exemple de la 
girafe, qui montrebien les limitesdeces comparaisons. 

Appartenance et test d'inclusion 

Tester si deux node- sets sont constitues des memes nceuds est beaucoup plus subtil ; e'est 
le meme probleme, en gros, que de tester si un noeud donne appartient ou non a un node- 
set. Pour cela I 'idee de base est d'ajouter au node-set le noeud en question ; si cela ne 
change pas le cardinal du node-set, e'est que le noeud s'y trouvait deja (puisqu'un node- 
set est un ensemble, et qu'a ce titre, il ne sauraity avoir des doublons). II faut done se 
debroui Her pour former un node-set (disons $p) ne contenant que le noeud a tester; 
poursavoir si ce noeud appartient a un autre node-set $q, il suffit de tester I'expression 

count( $p | $q ) = count( $q ). 
Note 

C'est cette idee qui a mis du temps a voir le jour. 

Detail amusant, on peut voir a I'adresse http://dpawson.co.uk/xsl/sect2/muench.html, que Michael Kay en a eu 
la revelation dans son bain. 
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Plus generalement, I'expression countc $p | $q ) = countc $q ) est vraie si et seule- 
ment si le node-set $p est inclus dans $q. 

Dans la meme veine, on voit immediatement que les deux node-sets $p et $q sont iden- 
tiques (egaux au sens mathematique du terme) si et seulement si : 

(count( $p | $q ) = count( $q )) and (countt $p | $q ) = count( $p )) 

Expressions mixtes 

Les expressions mixtes sont celles oil un argument est un node-set, et I'autre un type 
simple (Boolean, String, Number). 

• node-set = Boolean ou node-set i = Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si et seulement si le node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set = String ou node-set i = String 

L'egalite (respect, inegalite) est vraie si et seulement si le node-set contient au moins 
un nceud dont la valeur textuelle est egale a (respect, differente de) la String donnee. 

• node-set = Number ou node-set i= Number 

L'egalite (respect, inegalite) est vraie si et seulement si le node-set contient au moins 
un noeud dont la valeur textuelle, convertieen nombre, est egale au (respect, differente 
du) Number donne. 

• node-set < > <= >= Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si et seulement si le node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set < > <= >= Number 

La comparaison est vraie si et seulement si le node-set contient au moins un noeud dont 
la valeur textuelle peutetre convertieen un nombre pour lequel la comparaison avec le 
Number donne est vraie. 

• node-set < > <= >= String 

La comparaison est vraie si et seulement si le node-set contient au moins un noeud dont 
la valeur textuelle peutetre convertieen un nombre pour lequel la comparaison avec la 
String donnee, converti eel I eaussi avec succesen nombre, est vraie. Dans tous les cas, 
si jamais la String donnee ne peut pas etre correctement converti e en nombre, la 
comparaison estfausse. 

C'est ici que nous trouvons ces fameuses expressions bizarres, qui consistent (par ex- 
emple) a tester la relation d'inferiorite ou de superiorite entre un node-set et un booleen. 
Comme nous I'avons dit, la motivation essentielle de ce genre de conversion est de 
pouvoir ecrire de facon concise certains predicats frequents dans la pratique. 
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II n'est pas possible de montrer cela dans le detail des maintenant, mais on peuttout de 
meme donner une idee de la chose. Imaginons par exemple un document X M L formant 
un recueil de descriptions de maisons comme eel le que nous avons vue a la section 
Exemple d'arbre XML d'un document, page 38. Supposons de plus que nous ayons 
forme un node-set $ies-rdc qui contienttous les <rdc> detoutes les <maison>. 

On peut alors filtrer le node-set $ies-rdc par le predicat [ garage ] , comme ceci : 

| $les-rdc[ garage ] 

Cela donneun nouveau node-set qui necomportequedes rez-de-chausseeavec au moins 
un garage. M ais si cela donne cela, e'est parce qu'arrive a une certaine etape de I 'inter- 
pretation de cette expression, I 'interpreter XPath reclame une expression booleenne 
applicable a chaque element <rdc> candidat a faire partiedu nouveau node-set; si cette 
expression booleenne est vraie, le candidat est accepte, sinon il estrejete. Or, acestade, 
il se trouve que I 'expression garage est interpret.ee comme une valeur de type node-set : 
e'est la qu'intervient cette fameuse conversion de node-set en booleen, grace a laquelle 
I'interpreteur X Path va obtenir I 'expression booleenne qu'il attend. 

M ais voici quelqu'un qui voudrait voir toutes les maisons qui ont une terrasse en etage 
avec un palmier en zinc figurant le desert. Rien de plus facile : 

$les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

La encore, si cela fonctionne, e'est parce qu'au moment oil I'interpreteur XPath reclame 

SOn expression booleenne, On lui fOUmit terrasse = "Palmier en zinc figurant le 

desert". D 'apres ce que nous avons vu, cette expression estvraies'il I'on peuttrouverau 

moins Une <terrasse> dont la Valeur textuelle est egale a "Palmier en zinc figurant 
le desert". 

C'est done pour opti miser la facilite d'ecriture detels predicats que ces regies bizarres de 
conversion etdecomparaison ontete misesen place. C'estvrai que I 'on obtient alors des 
predicats assez concis, et qui se lisent assez bien ; mais des que I'on quitte le domaine 
des predicats, le cote bizarre de ces comparaisons reprend alors le dessus. 

II fautassumer. 
Conclusion 

Nous arrivons maintenant aux portes du temple XPath. Comme nous I'avons deja dit, 
XPath est essentiellement un langage d'expressions pour construire des node-sets 
contenant des nceuds preleves dans I 'arbre XML document source : de telles expressions 
s'appellent des chemins de localisation (location path), et ce sont el les que nous allons 
maintenant etudier. 
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Principes de la construction d'un chemin de localisation 

Note 

A lire des la premiere lecture. 



Nceud contexte 

Etant donne un certain nceud (appele nceud contexte) de I'arbre XML d'un document 
source, un location path (ou chemin de localisation) permet de designer ses voisins plus 
ou moins proches ou lointains, dans toutes les directions (ascendants, descendants, 
freres, cousins, etc.). 

Le nceud contexte, en tant que point de depart de la navigation dans I'arbre XM L d'un 
document, est unedes notions fondamentalesdu langageXPath, que I 'on retrouvera sans 
cessedans la suite. 

Chemin de localisation 

Un chemin de localisation a laformesuivante(exprimeeen utilisantla notation des DTD) : 

Location Path 

LocationPath = "/"?, LocationStep, ( "/", LocationStep )* 

Un chemin de localisation est done une suite d 'eta pes de localisation (location step) 
separees par des v. Le ■/■ initial indique un chemin absolu ; en son absence, on a un 
chemin relatif. 

Le noeud contexte est indispensable pour devaluation d'un chemin de localisation rela- 
tif ; pour un chemin absolu, le point de depart est la racine de I'arbre XM L du document 
(en cesens, on peutdirequ'un « chemin absolu » est relatif a la racine, alorsqu'un « che- 
min relatif » est relatif au nceud contexte). 

Evaluation d'un chemin de localisation 

Lorsqu'on evalue un chemin de localisation, on obtient un node-set, e'est-a-dire une col- 
lection de nceuds non ordonnee et sans repetition. On dit que le chemin de localisation 
selectionne un ensemble de noeuds. Ce processus de production d'un ensemble de nceuds 
repose sur la repetition d'etapes de localisation, chacunedeces etapes consistant essen- 
tiellement en un processus d elimination : on part d'un ensemble initial de nceuds, que 
I'on passe au crible uneou plusieurs fois (souvent uneseulefois), avec describles diffe- 
rents. 

Ce qui reste apres application de cette succession d'etapes, est I'ensemble de nceuds 
selectionne par le chemin de localisation. 

II faut maintenant voir chacun des constituants d'uneetape de localisation. 
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Etape de localisation 

Note 

A lire des la premiere lecture. 

Une etape de localisation a la forme suivante (notation DTD) : 

LocationStep 

LocationStep = Axis, NodeTest, Predicate* 

Chaque etape de localisation se compose done : 

• D'un axe de localisation, qui produit I 'ensemble initial de nceuds (a condition de 
connaitre le noeud contexte). L e mot axe vient de ce que cet ensemble initial est consti- 
tue a partir de nceuds choisis selon un critere evoquant une direction ou un axe de 
deplacement dans I 'arbre (parents, enfants, freres, etc.). 

• D'un premier crible (NodeTest, ou determinant ) permettantd'eli miner del 'ensemble 
initial de nceuds tous ceux qui ne repondent pas au critere indique par le NodeTest 
(qui porte sur la nature des nceuds a conserver). Ce premier crible permet par exemple 
dedirequ'on ne veut garder que les <piedDePage>, ou que les <figure>, etc. 

• Eventuellement de cribles supplemental res, appeles predicats, permettant de dire par 
exemple qu'on ne veut pas garder toutes les <figure>, mais seulement eel les qui ont 
un attri but 'type' egal a 'gif'. 

Exemple : 

LocationStep 

child: :figu re [attribute: :type='gif '] 

Cette etape de localisation se decompose ainsi : 

• child est I ' axe de localisation ; il fournit I 'ensemble de depart, constitue ici de tousles 
nceuds enfants directs du noeud contexte. 

• figure est le determinant (N odeTest) ; il permetd'eliminerdecetensemblede depart 
tous les nceuds qui ne sont pas des <f i gure> . 

• [attribute: :type='gif] est le premier (et I'unique) predicat, qui joue le role de 
deuxieme crible, elimi nant tous les nceuds <figure> n'ayant pas un attri but type egal 

a gif, 

Le principe de construction d'un node-set par une etape de localisation est done assez 
simple : on part d'un node-set initial fourni par un axe de localisation, qui est d'abord 
filtre par un determinant, puis par des predicats. 

Nous allons done voir maintenant plus en detail chacun deces constituants. 



Etape de localisation 

Chapitre 2 



Axes de localisation 

Mentionner un axe de localisation dans une etape de localisation permet d'obtenir un 
node-set initial, qui sera ensuite progressivement elague sous I'action du determinant 
(Node Test) puis des predi cats. 

L'idee est done qu'un axe de localisation represente une premiere approximation de ce 
que I'on veut, en se basant sur la notion de voisinage du nceud contexte : les enfants, les 
freres, les ascendants, etc. : on choisit ce qui se rapproche le plus du node-set souhaite, 
quitte ensuite a filtrer les nceuds en trop. L'approximation doittoujours sefaire par exces, 
puisqu'il est possible de filtrer, mais pas d'ajouter. 

Etant donne un nceud-contexte, un axe est done un ensemble de nceuds, partageant une 
propriety commune vis-a-vis du nceud contexte. 

Les treize axes de localisation 

Le standard X Path definit treize axes de localisation. Les onze premiers sont construits a 
parti r du nceud contexte sur la base de la relation parent-enfant, ce qui donne un arbre 
genealogique presque identique a I'arbreXM L du document source : il ne manque que 
les nceuds detype attribute et namespace. Precisement, les deux derniers axes corres- 
pondent aux attributs et domaines nominaux du nceud contexte, mais ils sont un peu a 
part, puisqu'il n'y a pas de relation parent-enfant complete entreun nceud et ses attributs 
ou domaines nominaux (revoir a ce sujet les sections No?ud de type attribute, page 33 et 
Nceud de type namespace, page 34). 

Voici la listedeces 13 axes : 

• child 

contientles nceuds enfants (directs) du nceud contexte. Necontientjamais de nceud de 
type attri but ou domai ne nomi nal . 

• descendant 

contient toute la descendance (enfants, petits-enfants, ...) du nceud contexte. Ne 
contientjamais de nceud detype attri but ou domaine nominal. 

• parent 

contient le parent du noeud contexte. Existe pour tout nceud contexte (meme de type 

attribute OU namespace), Sauf pour la racine (root). 

• ancestor 

contient les ascendants (parent, grand-parent, ...) du nceud contexte. Contient touj ours 
la racine (meme si le nceud contexte est de type attribute ou namespace), sauf si le 
nceud contexte est la racine. 

• self 

contient le nceud contexte et seulement le nceud contexte. 

• following-sibling 

contient les freres suivants (dans I 'ordre de lecture du document) du nceud contexte. 
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Si lenceud contexteestun nceud de type attri but ou domaine nominal, I 'axe foil owing- 
si bi ing est vide. 

• preceding-sibling 

contient les freres precedents (dans I 'ordrede lecture du document) du nceud contexte. 
Si le nceud contexte est un nceud de type attribut ou domaine nominal, I 'axe 

precedi ng-si bl i ng est vi de. 

• following 

contient tous les nceuds qui suivent le nceud contexte dans I'ordre de lecture du docu- 
ment, en excluant d'une part la propre descendance du nceud contexte, et d'autre part 
les nceuds de type attribut ou domaine nominal. 

• preceding 

contient tous les noeuds qui precedent le nceud contexte dans I'ordre du document, en 
excluant d'une part la propre ascendance du noeud contexte, et d'autre part les nceuds 
detype attribut ou domaine nominal. 

• descendant-or-self 

contient le nceud contexte et tous ses descendants (commeson nom I'indique). 

• ancestor-or-self 

contient le nceud contexte et tous ses ascendants (comme son nom I'indique). En 
consequence, contient touj ours la racine. 

• attribute 

contient les attri buts du nceud contexte si le nceud contexte est un element ; est vide 
dans le cas contraire. 

• namespace 

contient les domainesnominaux du nceud contexte si lenceud contexteestun element ; 
est vide dans le cas contraire. 

Representation graphique 

On peut representer graphiquement (voir figure 2-10) les ensembles de nceuds que 
forment les axes (les axes attri bute et namespace ne sont pas montres, et I 'un des nceuds 
e I ement est pris arbitrairement comme nceud contexte). 

Note 

La figure 2-10 est tres largement inspiree d'un schema extrait de « Practical Transformation Using XSLT and 
XPath », un support de cours et un livre sans nom d'auteur (copyright 1998-2001 Crane Softwrights Ltd.) dont un 
extrait est disponible sur www.cranesoftwrights.com/training/. 

On voit sur la figure 2-10 que I 'axe child d'un element peut contenir des nceuds detype 

el ement, maiS aUSSi detype processing instruction, text, OU comment. A fin de pOUVOir 

trier, on dispose de possibility detests adequats (voir Determinant (Node Test), page 54). 
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descendant-or-self 



o § © • o 

nceud processing nceud comment noeudtext nceud element 

contexte instruction 

Figure 2-10 

Representation des axes de localisation en tant qu 'ensembles. 

D 'autre part, les numeros des nceuds sur cette figure correspondent a I 'ordre d'apparition 
de leur balise ouvrante, lors de la lecture sequentielle du document X M L correspondant, 
qui ressembledonc aceci (I e noeud 9 est I e nceud contexte) : 

<i> 

<2> 

<3/> 
<4/> 
<5> 

<6> 

<7/> 

</6> 
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<8/> 
<9> 

<? processing-instruction ?> 
<10> 

<ll/> 
<12/> 
</10> 

<!-- commentaire --> 

<13> 

<14/> 

<15/> 
<13/> 
un texte 

</9> 

<16/> 

<17> 

<18/> 
</17> 

</5> 

<19/> 

<20/> 

</2> 

</l> 

Remarque 

Sur la figure 2-10, on voit le node-set sel f , qui ne comporte qu'un seul element. Pourtant, cet element possede 
une descendance assez nombreuse : il est important de realiser qu'un node-set peut tres bien contenir un 
element sans pour autant contenir les enfants ou la descendance de cet element. Mais ce n'est pas interdit non 
plus : voir par exemple le node-set descendant-or-sei f. 

LeS axes parent, ancestor, ancestor-or-sel f , preceding, et preceding-sibling ne 

contiennent que des nceuds situes avant (par rapport au nceud contexte) dans I'ordre de 
lecture du document : on les nomme axes retrogrades. 

Tous les autres axes (y compris les axes attribute et namespace) ne contiennent que des 
nceuds situes apres (par rapport au noeud contexte) dans I'ordre de lecture du document : 
on les nomme axes directs. 

L'ordre de lecture du document, pour les attributs et les domaines nominaux, est un peu 
arbitraire par certains cotes. La regie est celle-ci : les attributs et domaines nominaux 
viennent apres leur element parent, et avant les enfants de ce parent (ce qui est somme 
toute parfaitement logique, et correspond effectivement a I'ordre de lecture du docu- 
ment). Cequi est arbitraire, c'estque les domaines nominaux viennent avant les attributs 
(c'est une simple convention). M ais aucun ordre de lecture de document n'est defini pour 
classer les attributs entre eux, ni les domaines nominaux entre eux, car I'ordre dans 
lequel ils apparaissent n'est pas cense etre signifiant (cette propriety est imposee par 
XML). 
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Indices de proximite 

On definit aussi une numerotation des nceuds relative a un axe, dont les numeros, appeles 
indices de proximite, commencenttoujours a 1. 

Pour un axe direct (par. ex. child ), les indices de proximite augmentent quand on s'e- 
loigne du nceud contexte en suivant I 'ordre de lecture du document, alors que pour un axe 
retrograde (par. ex. preceding-sibling ), les indices de proximite augmentent quand on 
s'eloigne du nceud contexte dans I 'ordre inverse de lecture du document. 

A titre d'exemple, reprenons la figure 2-10 , et montrons les indices de proximites pour 

deUX axes retrogrades (preceding, ancestor-or-self), et pour 2 axes directs (descen- 
dant, following). Ces indices de proximite sont montres sur la figure 2-11 (les anciens 
numeros sont rappeles en plus petit, a I'exterieur de chaque cercle). 
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Figure 2-11 

Indices de proximite. 




La regie, pour un node-set intervenant dans une etape de localisation, est que les indices 
de proximite donnent I 'ordre d'enumeration. 
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Remarque 

Ces indices de proximite servent (entre autres) a fournir, quand besoin est, un ordre d'enumeration. Un node-set, 
rappelons-le, est un ensemble, et a ce titre, n'est pas ordonne. Pas ordonne, cela signifie que I'ordre d'enumera- 
tion des elements n'est pas une propriete discriminante lorsqu'on cherche a distinguer deux ensembles : les 
ensembles {x,y} et {y,x} sont indiscernables. 

Ceci etant, lorsqu'on enumere un node-set, par exemple pour traiter chacun de ses elements un par un, il taut 
bien choisir un premier, un deuxieme, etc. jusqu'a un dernier. Done meme si un node-set n'est pas ordonne, il est 
certainement utile, dans la pratique, d'avoir a sa disposition un algorithme d'enumeration. 

Determinant (Node Test) 

Etant donne un ensemble de nceuds fourni par un axe de localisation, le determinant est 
unefonction booleenne, qui, appliqueea un noeud decet ensemble, ditsi cenceud doitou 
non rester dans I 'ensemble. 

L'ecriture : 

Axis: :NodeTest 

denote I 'ensemble obtenu en appli quant le determinant NodeTest a chaque element de 
I'axe Axis. 

II y a plusieurs possibility pour un NodeTest : pour chacune d'elle, on doit specifier la 
fonction booleenne, e'est-a-dire expliquer le critere mis en ceuvre pour accepter ou reje- 
ter un noeud. Pour cela, il est necessaire d'introduire une nouvelle notion, eel le de type 
principal de na?ud. 

Le type principal de noeud d'un axe de localisation, e'est le type de nceuds les plus fre- 
quemment contenus dans cet axe. 

• L'axe attribute ne contient que des nceuds de type attribute, son type principal de 

noeud est done attribute. 

• L'axe namespace ne conti ent que des nceuds de type namespace, son type principal de 

nceUd est done namespace. 

• Les onze autres axes peuvent contenir aussi bien des nceuds de type element, que de 

type comment, OU processing-instruction, OU root, OU text. NeanmoinS, le pi US fre- 
quent, et de loin, est qu'ils contiennent des elements. Le type principal de noeud est 

done el ement, 

Ceci etant, nous al Ions pouvoir maintenant passer en revue les differentes formes pos- 
sibles pour un determinant (NodeTest). 

Le determinant est un nom 

Node Test = nom 



Axi s : mom 
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L e determinant est ici un nom (d'element, d'attribut, ...). Applique a un noeud de I'axede 
localisation indique, le determinant accepte ce noeud si le type du noeud est egal au type 
principal de noeud del'axechoisi, etsi lenom du noeud coincide avec lenom constituant 
I e determinant ; dans lesautres cas, le noeud est rejete, et done nefait pas parti edu node- 
set resultant. 

Exemple : 

child: ifigure 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les elements de I'arbre XML considers, qui sont des enfants du noeud 
contexte, et dont le nom est figure. Tous les autres noeuds sont rejetes : 

• soit a cause de leur type qui n'est pas egal au type principal de noeud (element pour 
I 'axe child) ; 

• soit a cause de leur nom qui n'est pas egal a f 1 gure. 

La premiere cause de rejet (portant sur le type) permet d'eliminer par exemple une 
processing-instruction qui par malchance sedenommerait elleaussi^gure. 

Le determinant est une * 

Node Test = * 

Axi S : :* 

Une * est un determinant qui ne filtre que le type de noeud : sont rejetes tous les noeuds 
dont letype ne correspond pas au typede noeud principal associe a I 'axe indique. 

Exemple : 

child: :* 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les noeuds de type ei ement, enfants du noeud contexte. 

Autre exemple : 

attribute: :* 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les noeuds de type attri bute, qui ont pour parent le noeud contexte, e'est- 
a-dire, pour parler plus si mpl ement, tous les attri buts du noeud contexte. 

Le determinant est un descripteur de type 

C e genre de determinant teste letype de noeud a selectionner. En cesens, la selection est 
plus fine que dans le cas precedent, avec I'etoile. U ne etoile teste aussi le typede noeud a 
selectionner, mais le type est impose par I'axe mentionne (e'est le type principal de 
noeud). Ici, le type est a choisir parmi quatre valeurs possibles, et le type principal 
de noeud associe a I'axede localisation mentionne n'intervient pas. 
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Node Test = type 

Axis: :type 

Les quatrevaleurs de types possibles (avec unevariante) sont les suivantes : 

• text() 

textc ) est un determinant qui selectionne tout nceud de type text, et rejette tous les 
autres. 

• commentO 

commento est un determinant qui selectionne tout nceud de type comment, et rejette 
tous les autres. 

• processing-instructionO 

processi ng-i nstructi on o est un determinant qui selectionne tout nceud de type 
processing-instruction, et rejette tous I es autres. 

• processing-instruction( « xxx » ) 

processing-instruction( "xxx" ) est un determinant qui selectionne tout nceud de 
type processing-instruction dontlenom est xxx, et rejette tous les autres. 

• node() 

nodeo est un determinant qui ne rejette aucun nceud. Et comme le type principal de 
nceud n'intervient pas, (ni danscecas, ni dans les quatre autres ci-dessus), on a done le 
contenu de I'axe de localisation au grand complet. 

Exemples : 

child::text() 

selectionne les nceuds de type text, enfants du nceud contexte. 

chi Id: :comment( ) 

selectionne les nceuds de type comment, enfants du nceud contexte. 

child: : process i ng -instruct!' on ( ) 

selectionne les nceuds de type processi ng-i nstructi on, enfants du nceud contexte. 

child: :processing-instruction( "play" ) 

selectionne les nceuds de type processi ng-i nstructi on, enfants du nceud contexte, et 
dont le nom est « play ». 

child: :node( ) 

selectionne tous les nceuds enfants du nceud contexte. On obtient done un node-set iden- 
tique a I'axe de localisation. C'est utile si on veut filtrer par d'autres criteres que ceux 
predefinis par les determinants possibles; dans ce cas, on ne filtre rien au niveau du 
determinant, mais on exprime le filtre dans le ou les predicats. 
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Predicats 

U n predicat permet d'affiner lefiltragedeja effectue par I e determinant sur I'axede loca- 
lisation choisi, en eliminant de I 'ensemble resultat les nceuds qui ne repondent pas a un 
certain critere, dont I 'expression constitue precisement le predicat. 

II a la forme suivante : 

Predicat 

[ Boolean-Expression ] 

Un predicat s'appliquea un ensemble de nceuds (node- set) etproduitun nouveau node-set. 

Le node-set de depart peut avoir di verses origines : il peutstre I e resultat du filtraged'un 
axe de localisation par un determinant, ou encore le node-set produit par un autre predi- 
cat. II peut meme etre n'importe quel node-set reference par une variable, comme dans 
I'exemple : 

$les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

qui nous a servi a expliquer les raisons de certaines bizarreries (voir la fin de la section 
Expressions mixtes, page 45). 

Note 

Nous parlons ici a nouveau de variable ; il est vrai que nous n'avons pas encore vu la fagon de declarer et 
d'initialiser une variable ; cela viendra bien plus tard, a la section Instruction xshvariable, page 179. En effet, 
XPath ne definit pas la notion de variable, mais uniquement celle de reference a une variable, avec la notation 
$xxx. La notion de declaration et d'initialisation de variable est une notion propre a XSLT. II est done impossible, 
a ce niveau, de montrer un exemple oil une telle variable serait initialisee. 

Comme le resultat du filtraged'un node-set est a son tour un node-set, on peut (eventuel- 
lement) lui appliquer de nouveau un predicat, etainsi de suite : 

Predicats en cascade 

Axis: :NodeTest[Boolean-Expression][Boolean-Expression] . . . [Boolean-Expression] 

Contexte devaluation d'un predicat 

Le resultat de devaluation d'un predicat est un nouveau node-set, initialement vide, puis 
progressivement constitue en examinant un par un chaquenceud de I 'ensemble de depart, 
et en testant s'il doit ou non faire partie du node-set resultat. 

Ce node- set de depart (appelons-le N SD ) est necessairement un sous-ensemble d'un axe 
de localisation, qui lui-meme n'existe que par rapport a un nceud contexte. On est done 
ici dans une situation oil un noeud contexte NC est defini, et oil un axe de localisation a 
ete choisi, donnant I e node-set NSD (apres un eventuel filtrage par un determinant). 

L'expression booleenneentre crochets, qui constitue I e predicat, estevaluee pourchaque 
element du node-set NSD ; cette evaluation se fait relativement a un contexte, appele 
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contexte d 'evaluation, comportant trois informations, et construit dynamiquement pour 
chaque element du node-set NSD : 

• le nceud en cours d'examen, considere d' office comme nceud contexte temporaire, si 
jamais I 'expression booleennea evaluer en a besoin d'un ; 

• lenombre total denceuds del 'ensemble NSD (accessible par appel a la fonction prede- 
fine lasto) ; 

• et I 'indice de proximite qui a ete affecte au nceud en cours d'examen, lors de la construc- 
tion du node-set NSD (accessible par appel a la fonction predefinie positionc )). 

Grace a ce contexte devaluation, tout predicat, aussi complexe soit-il, peut etre evalue. 
En voici quelques exemples : 

Predicat utilisant 1 'indice de proximite conserve dans le contexte (revaluation 

child: :figure[ positionO = 3 ] 

Etantdonne un certain nceud contexteNC, child: :figure selectionne un node-setNSD 
contenanttous I es elements de I'arbreXM L considere, enfants dece nceud contexte NC, 
etdontlenom est figure. A partirdela, I e predicat est evalue : pour chaque element du 
node-setNSD, I'expression booleenne position( ) = 3estevaluee. Lafonction predefi- 
nie position ( ) renvoiela valeur del 'indice de proximite du nceud en cours d'examen : si 
cette valeur est 3, le noeud est conserve dans le node-set resultat, sinon il est rejete. Au 
final, on obtient done un node-set d'au plus un element, qui est la troisieme <figure>, 
enfant du nceud contexte N C . 

Predicat utilisant le nombre total de nauds conserve dans le contexte devaluation 

child: :figure[ positionO = lastO ] 

lei, le node-set NSD est constitue de la memefacon, mais le predicat est legerement dif- 
ferent : la fonction predefinie iast( ) renvoie le nombre total d'elements de NSD ; done 
leseul element qui nesera pas rejete par I e predicat sera I e dernier, puisque I es indices de 
proximite commencent a la valeur 1. Au final, on obtient done un node-set d'au plus un 
element, qui est la derniere <figure>, enfant du nceud contexte NC. 

Predicat utilisant le naud contexte temporaire conserve dans le contexte 
d'eval uation 

child: :figure[ attribute: :type = 'gif ] 

lei, le node-set NSD est a nouveau constitue de la memefacon, mais le predicat est com- 
pletement different. II sera analyse plus en detail un peu plus loin ; nous nous contente- 
rons pour I 'instant devoir comment intervient le nceud contexte temporaire. 

Pour chaque element du node-set NSD, il s'agit de comparer un node-set (le node-set 
attribute: :type) a une chaine de caracteres. La premiere chose a faire est done d'evaluer 
le node-set attribute: :type, fourni ici sous la forme d'une etape de localisation, basee 
sur I'axede localisation attribute. M ais I 'evaluation d'un axede localisation reclame un 
nceud contexte : le contexte devaluation en fournit un, e'est le nceud en cours d'examen. 
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Chaque nceud examine devientdonc tour a tour « noeud contextetemporaire» dans I 'eva- 
luation de I 'etape de localisation attribute: :type, qui selectionne tous les attributs du 
noeud contextetemporairedont lenom est "type". On obtientalors un node-set d'au plus 
un noeud (qu'il s'agit ensuite de comparer a une String : voir Predicat sous la forme 
[node-set], page 59). A u final, on obtient un node- set constitue detoutes les <figure> qui 
sont des enfants du noeud contexteNC, etqui ontun attribut "type" egal a -gif. 

Conversion booleenne de node-set 

Nous avons deja assez longuement evoque dans la section Expressions avec arguments 
de type node-set, page 42 les expressions mettant en jeu des node-sets pour obtenir un 
booleen. M ais il n'est peut-etre pas inutile d'y revenir, en se placant ici dans le contexte 
precis de devaluation d'un predicat. 

II peut arriver que, dans un predicat, I 'expression entre crochets [...] ne soit pas une 
expression booleenne. Danscecas, elleestconvertieen expression booleenne, suivantun 
algorithmequi depend dela nature de I 'expression, etqui peut paraitre, on I'a vu, un peu 
surprenant. Dans la pratique, deux cas se produisent assez souvent : I'expression entre 
crochets est un node-set, ou bien est la comparaison d'un node-set et d'une chalne de 
caracteres. 

Predicat sous la forme [node-set] 
Exemple 

child: :figure[ attribute: :scale ] 

D'une manieregenerale, un node-set, quelqu'il soit, peutetreconverti en une expression 
booleenne: la conversion donne la valeur « vrai »si etseulementsi I e node-set n'est pas 
vide. 

M ais pour evaluer un node-set tel que attribute: :scaie (ne serait-ce que pour savoir 
s'il est vide ou non), il fautun noeud contexte: ce noeud contexte est eel ui qui estfourni 
par le contexte devaluation (voir ci-dessus). 

II en resultequ' une etape de localisation telle que : 

child: :figure[ attribute: :scale ] 

selectionne les <figure>, enfants du noeud contexte courant, ayantun ensemble d' attributs 
scale non vide, e'est-a-dire (plus simplement) les <figure>, enfants du noeud contexte 
courant, ayant un attribut scale. 

Autres exemples 

child: :figure[ parent: :paragraphe ] 
child::*[ self : :figure or sel f: : image ] 

Le premier selectionne les <figure> enfants du noeud contexte dont I e noeud parent est un 
<paragraphe> ; le deuxieme selectionne toutes les <figure> ou <image> enfants du 
noeud contexte. 
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Ce deuxieme exemple est assez typique de la fagon donton peut tester lenom d'un ele- 
ment : self: :image est une etape de localisation a evaluer ; pour cela, il faut un nceud 
contexte. Or, on est dans un predicat, done le contexte d'evaluation fournit le nceud en 
cours d'examen comme nceud contexte temporaire. L'axe self selectionne done un 
node-set ne contenant que le nceud en cours d'examen ; on filtre ce node-set en ne 
conservant le nceud qu'il contient, que si son nom est image et son type est element , 
puisque e'est le type principal de nceud pour l'axe self. En fin decompte, du node-set de 
depart child: :*, qui contient tous les elements enfants du noeud contexte, sont rejetes 
tous les elements qui nesont pas des <figure> ou des <image>. 

Predicat sous la forme [node-set = String] 
Exempl e 

child: :figure[ attribute: :scale = "0.5" ] 

Ce genre d'expression est convertie en valeur booleenne d'une facon deja evoquee a la 
section Expressions mixtes, page45. On peutfaireici uneevaluation pasapas, neserait- 
ce que pour se persuader que cen'est pas si trivial que cela, memesi au final I'expression 
se lit plutot bien. 

L'expression : 

child: :figure 

produit un node-set contenant toutes les <figure> appartenant au node-set child, lui- 
meme calcule par rapport a un certain nceud contexte. Soit { fi, fz, f3, f4 } cet 
ensemble de <figure>. 

Le predicat : attribute: :scaie = "0.5" ] s'applique a cet ensemble ; e'est-a-dire 
que pour chaque element fi, fz, f3, f4 de cet ensemble, on evalue le predicat 
[ attribute: :scaie = "0.5" ] pour savoi r s'i I est vrai ou faux. 

Pourcefaire, on prend un element, par exemple fi, eton construitle contexte d'evaluation : 

• le nceud en cours d'examen estfi, etserviraeventuellementde nceud contexte tempo- 
raire; 

• lenombred'elements del 'ensemble de depart est 4 ; 

• I'indice de proximite de f 1 est 1 (en tout cas, on fait cette hypothese, qui n'est pas plus 
mauvaisequ'une autre). 

M uni du contexte d'evaluation, on peut commencer le calcul du predicat : 

• L'expression attribute: :scaie denote un ensemble de nceuds selectionne par l'axe 
de localisation attribute et filtre par un determinant scale. Le contenu de cet axe de 
localisation se determine par rapport a un nceud contexte ; le nceud contexte est ici 
fourni par le contexte d'evaluation, qui donne fi. L'axe de localisation correspond 
done a I'ensembledes nceuds de type attribute attaches a fi. Cet axe est filtre par le 
determinant scale ; on obtient done I'ensemble A des attributs de fi ayant pour nom 
seal e (dans ce cas particulier cet ensemble a au plus un element). 
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• Le predicat a evaluer est done [ a = "0.5- ], oil A est I'ensemble precedemment 
determine. 

• Nousavons vu comment evaluer une telle expression : el le est vraie si etseulementsi 
I'un des elements de A a unevaleurtextuelleegalea« 0.5 ». 

• Done, finalement, pour chaque element fi, fz, f3, f4, on peut savoir si le predicat 

[attribute: : scale = "0 . 5" ] est Vrai OU faUX. 

Ainsi I'ensemble de depart child: :figure peut etre filtre par le predicat, et le resultat 
correspond done bien a I 'ensemble de toutes les <f i gure> de I'axe chi 1 d (relatif au noeud 
contexte courant), ayant un attri but scale egal a « 0.5 ». 

Exemples de predicats dans une etape de localisation 

child: : paragraphe[ child: :figure ] 

selectionne les <paragraphe>, enfantsdu noeud contexte, qui possedent un (au moins un) 

enfant <figure>. 

child: :chapitre[ descendant: :figure ] 

selectionne les <chapitre>, enfants du noeud contexte, qui possedent un (au moins un) 
descendant <figure>. 

child: :paragraphe[ child::* ] 

selectionne les <paragraphe>, enfantsdu noeud contexte, qui possedent un (au moins un) 
enfant. 

child: :*[ child: :figure ] 

selectionne les elements enfants du noeud contexte, qui eux-memes possedent un (au 
moins un) enfant <figure>. 

child::*[ self : :chapitre or self::annexe ] 

selectionne les elements enfants du noeud contexte qui sont des <chapitre> ou des 

<annexe>. 

child: :paragraphe[ child: :figure[position() = 2] ] 

selectionne les <paragraphe>, enfants du noeud contexte, qui possedent au moins deux 
<figure>. En effet, on filtre un node-set constitue de <paragraphe>, en se basant sur le 
fait que le node-set de ses enfants de type element et de nom fig ure contient un 
deuxieme element; s'il y a un deuxieme, c'estqu'il y a un premier, done qu'il y a au 
moins deux enfants. 

child: :paragraphe[ child: :*[position( ) = 2][self : :figure] ] 

selectionne les <paragraphe>, enfantsdu noeud contexte, dont I e deuxieme enfant de type 
element est une <figure>. Voyez la difference avec I'exemple precedent : ici le predicat 
[ positiono = 2 ] porte sur un node-set qui contient tous les enfants de type element 
(a cause de I'etoile qui teste uniquement le type principal de noeud), alors que dans 
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I'exemple precedent, le meme predicat fil trait un node-set ne comportant que des 
<f igure> : mais la deuxieme figure n'est pas forcement le deuxieme element. 

child: :paragraphe[ child: :node()[position() = 2][self : :figure] ] 

selectionne les <paragraphe>, enfantsdu nceud contexte, dontle deuxieme enfant est une 
<figure>. Voyez la difference avec I'exemple precedent : ici le predicat [ positiono 
= 2 ] portesur un node-set qui contienttous les enfants : mais le deuxieme element n'est 
pas forcement le deuxieme enfant (en plus des elements, il peut y avoir des textes, des 
commentaires, des processing-instructions). 

child: :paragraphe[ chi Id: :node( ) [sel f : :f igure][position( ) = 2] ] 

selectionne les <paragraphe>, enfants du noeud contexte, qui possede au moins deux 
<figure>. Voyez la difference avec I'exemple precedent : ici le predicat [ positiono 
= 2 ] portesur un node-set qui necontientquedes <figure>. C et ex emple est done equi- 
valent a : 

|child::paragraphe[ child: :figure[position( ) = 2] ] 
child::*[ self : :chapitre or self::annexe ][position() = lastO] 

constituele node-set des elements enfantsdu noeud contexte qui sontdes <chapitre> ou 
des <annexe> ; dans ce node-set, selectionne le dernier element. Ici, I'on peut imaginer 
qu'on a un livre avec des chapitres eteventuel I ement des annexes, et que les annexes, s'il 
y en a, sont placees apres les chapitres. Cetteetapede localisation selectionne le dernier 
chapitre s'il n'y a pas d'annexe, ou la derniere annexe, s'il y en a au moins une. 

/descendant: :text()[ start-with( self : :node( ) , "Horaires" ) ] 

selectionne tous les nceuds text du document qui commencent par "Horaires". start- 
witho est un fonction booleenne predefinie. 

child: :mohican[ positionO = lastO ] 

selectionne le dernier des M ohicans. 
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Note 

A lire des la premiere lecture. 

Un chemin de localisation a la forme suivante : 

Chemin de localisation 

LocationPath = "/"?, LocationStep, ( "/", LocationStep )* 

Exemple de chemin de localisation relatif 

child: :chapit re/child: : section 
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Exemple de chemin de localisation absolu 

/child: :chapitre/child: :section 

II y a done deux formes de chemins de localisation : les chemins de localisation absolus, 
et les chemins de localisation relatifs, suivant qu'il y a ou non un «/» initial dans 
I 'expression. 

Mais, dans tous les cas, un chemin de localisation n'est compose que d'etapes de locali- 
sation. Or une etape de localisation produit un node-set; le probleme de devaluation 
d'un chemin de localisation se ramifie done en deux sous problemes : d'une part savoir 
que faire de tous ces node-sets, et d'autre part, savoir comment interpreter semanti- 
quement cette cascade d'etapes de localisation. 

Evaluation d'un chemin de locaiisation 

Evaluation d'une etape de localisation par rapport a un node-set 

Nous avons vu precedemment comment evaluer une etape de localisation par rapport a 
un noeud contexte. Nous avons vu que ce nceud contexte est indispensable pour former, 
a" apres I 'axe de localisation choisi, I e node-set originel qui sera ensuite filtre. 

Nous vi sons maintenant un peu plus haut : evaluer une etape de localisation par rapport a 
un node-set A non vide. Si ce node-set ne contient qu'un seul element, cela ne change il 
estvrai pas grand-chose. Maiss'il en contient pi usieurs ? 

SoitA un tel node-set, contenantn nceuds. Pour evaluer leresultat d'une etape de locali- 
sation par rapport au node-set A, on evalue n fois cette etape de localisation en prenant a 
chaquefoisun noeud different du node-set A comme nceud-contexte. Ces n evaluations sont 
independantes les unes des autres, et produisent done n differents node-sets en resultat. 

Le resultat de cette evaluation est tout simplement un nouveau node-set, resultant de la 
fusion de ces n node-sets (union ensembliste de ces n node-sets). 

Une propriete agreable de cette operation est qu'elle prend en entree un node-set, et 
qu'elle fournit en sortieun nouveau node-set : il est done possi bled' avoi r des eval uati ons 
d'etapes de localisation enchalnees en cascade. 

Evaluation d'un chemin relatif 

Un chemin de localisation relatif donne un node-set qui se calcule par rapport a un noeud 
contexte donne. 

Le node-set resultat est obtenu en enchainant, dans I'ordre ou elles apparaissent (de 
gauche a droite), les etapes de localisation qui composent le chemin, la premiere etape 
etant calculee par rapport au noeud contexte. 

Evaluation d'un chemin absolu 

Un chemin de localisation absolu se calcule comme un chemin relatif, aceci presquele 
noeud contexte de depart est impose : c'estla racinedel'arbreXM L du document source. 
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Cle pour la lecture d'un chemln de localisation 

Un chemin de localisation determine un ensemble denceudsdontlecalcul sefaitcomme 
indique ci-dessus, eten principe, d'un strict point devuedu langage, il n'y a pas besoin 
d'endire plus. Neanmoins, il estbien evident que c'est particulierement frustrant de ne 
pouvoir lireun chemin de localisation « a la volee», pour en apprehender la semantique. 
Prenez par exemple le chemin de localisation suivant (qui n'a pourtant rien d'extraordi- 
naire) : 

parent: :chapit re/child: :section[position( ) = 3] /attribute: : niveau 

A moins d'etre entraine, il n'est pas evident dedechiffreravueunetelleexpression etde 
savoir la nature exactedes nceudsselectionnesau premier coup d'ceil. II est pourtant pos- 
sible de lire « a la volee» un tel chemin de localisation, a condition deconnaitrela cle de 
lecture. 

La cle de lecture est celle-ci : quand on lit un chemin de localisation pour calculer 
I 'ensemble des elements, il faut lire I 'expression de gauche a droite ; mais quand on le lit 
pour en apprehender qualitativement la signification, il faut le lire de droite a gauche (a 
I'envers). 

II est tout a fait possible de decrire un algorithme de lecture capable de faciliter grande- 
ment les debuts dans ce domaine. Nous allons le presenter en deux etapes, en traitant a 
part lecas des predicats. 

Lecture d'un chemin de localisation sans predicat 

Le chemin de localisation est ecrit sous le forme d'une succession d'etapes de localisa- 
tion, comme ceci : 

etapel/etape2/etape3/. . ./etapeN 

Danscetteecriture, chaqueetapeest dela forme a: :b, ou a est un nom d'axede localisa- 
tion, et b un determinant. 

• (S) : chaque«/», danscetteecriture, seprononce« des ». 

• (E) : chaqueetapeseprononce« b qui sontlesa ». 

• (i) : on commence par prononcer « Les ». 

• (F) : on termine en prononcant « du nceud contexte » ou « de la racine » suivant que 
le chemin est un chemin relatif ou absolu. 

Globalement, la phrase a prononcer pour comprendre ce que veut dire 

etapel/etape2/etape3/. . ./etapeN 

estobtenueen partantdel'etapeN, en remontant vers I 'etapei, eten appl i quant I es regies 
(i) au debut, (F) a la fin, et (E) (S) a chaqueetape, sauf la derniere : 

(I) (E)(S) ... (E)(S) (E)(S) (E) (F) 
etapeN etape3 etape2 etapei 
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Ainsi par exemple, lechemin : 

child: :chapit re/child: : section/attribute: : niveau 

est lu en appli quant les regies : 

• ( i ) : L es 

• (E) : niveaux qui sont les attributs 

• (S) : des 

• (E) : sections qui sont les enfants 

• (S) : des 

• (E) : chapitres qui sont les enfants 

• (F) : du noeud contexte 

Ce qui donne : Les niveaux qui sont attributs de sections qui sont les enfants des cha- 
pitres qui sont les enfants du nceud contexte . 

II peut parfois arriver qu'un nom d'axe soit assez peu compatible avec le pluriel (par 
exemple parent ou self, encore que self intervienne plus souvent dans un predicat) ; 
dans cecas on recti fie, pour rendre la phrase plus conformed I'intuition. 

parent: :chapitre/child: :section/attribute: :niveau 

Ce qui donne : les niveaux qui sont les attributs des sections qui sont les enfants du cha- 
pitre qui est le parent du noeud contexte. 

Lecture d'un chemin de localisation avec predicats 

La presence de predicats perturbe incontestablement la fluidite de lecture d'un chemin de 
localisation, parce qu'elle contrarie lesens retrograde de lecture du chemin : 

. . ./a: :b[c]/etapeN 

Lorsqu'on commence la phrase de description, en partant de la fin, etqu'on arriveaa: :b, 
on doit a ce moment tenircompte d'un predicatcense restreindreun node-set construit en 
partant du debut, et non en partant de la fin. Or a ce point, on ne connait pas encore le 
node-set qu'il s'agit de filtrer. Ceproblemen'estpastoujours bloquant, car certains pre- 
dicats, notamment ceux qui ne font pas appel a la fonction predefinie positiono, 
s'accommodent assez bien de la souplessede la langue naturelle. 

child: :chapit re/child: : section [child: : figure] /attribute: : niveau 

Lecture : 

• ( i ) : L es 

• (E) : niveaux qui sont les attributs 

• (S) : des 

• (E) : sections (ayant des enfants^gure) qui sont les enfants 
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• ( s ) : des 

• (E) : chapitresqui sont les enfants 

• (F) : du nceud contexte 

lei, parler de <section> sans restriction, ou d'elements <section> ayant des enfants 
<figure> ne change pas grand chose a la structure de la phrase qui reste comprehensible, 
meme si I'origine deces <section> est miseen attenteet reporteea la fin de la phrase. 

Cependant, lorsqu'un predicat fait usage de la fonction positiono, il est plus difficile de 
formuler une phrase comprehensible, parce que cette position est relative a un node-set 
enumerable que I'on ne connait pas encore. 

Une solution, qui marche a tous les coups, consiste a mettre en attente le predicat, au 
moyen d'unenoteavec renvoi. 

child: : chapi t re/child: :section[position( ) =2] /attribute: : niveau 

• (i) : Les 

• (E) : niveaux qui sont les attributs 

• (S) : de(s) 

• (E) : certaines (1) sections qui sont les enfants 

• ( s ) : des 

• (E) : chapitresqui sont les enfants 

• (F) : du noeud contexte 

• (note i) uniquement celle qui a la position 3 dans I'ensemble de sections dont il est 
question. 

Lecture d'un chemin de localisation dans un predicat 

II peut arriver de rencontrer un predicat qui contienne lui-meme un chemin de localisa- 
tion : 

child: :paragraphe[ child: :figure/attribute: :scale ] 

II y a alors une difference essenti el I e entre la lecture d'un chemin de localisation en tant 
que tel, et la lecture d'un chemin de localisation faisant partie d'un predicat, comme ci- 
dessus. En effet, dans le premier cas, il s'agit de construire un node-set dont la comple- 
tude est primordiale; dans le deuxieme cas, il s'agit seulement d'evaluer ce node-set 
comme expression booleenne : il peut bien y avoir 3000 elements dans le node-set, peu 
importe : un seul suffit pour savoir qu'il est non vide et donner la reponse booleenne. 

II en serait de meme, si I'on avait : 

child: :paragraphe[ child: :figure/attribute: :scale = "0.5" ] 

On n'aurait que faire de connaitre in-extenso le node-set child: :figure/attribute: : 
scale, il nous suffirait de savoir si au moins un element du node-set est egal a "0.5". 
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Dansces conditions, il devient possible de lire lechemin de localisation du predicatdans 
le sens normal, car on n'a plus besoin de formuler une phrase qui exprime la total ite du 
contenu des etapes de localisation traversers. 

A i nsi , I es etapes de I ocal i sati on ci -dessus peuvent se I i re respecti vement : 

• les <paragraphe> (ayant un enfant <figure> ayant un attri but scale) qui sont les 
enfants du nceud contexte ; 

• les <paragraphe> (ayant un enfant <figure> ayant un attri but scale egal a "0.5") qui 
sont les enfants du nceud contexte. 

Naturellement, les expressions « ayant un enfant » ou « ayant un attri but » si gni fient en 
fait « ayant au moins un enfant » ou « ayant au moins un attri but ». 

Remarque 

II ne faut pas considerer que lorsque revaluation de deux predicats exprimes sous la forme de chemins de loca- 
lisation donne le meme resultat, les chemins de localisation associes sont equivalents. 



Par exemple, les deux predicats ci-dessous donnent le meme resultat : 

|child::paragraphe[ child: ifigure/attribute: :scale ] 
child: :paragraphe[ child: :figure[ attribute: :scale ] ] 

Pourtant, les chemins de localisation associes, a savoir child: : figure/attribute: : 
scale et child: :figure[ attribute: : scale ] sont differents, puisque le premier selec- 
tionne des attri buts scale, alors que le deuxieme selectionne des elements <f i gure>. 1 1 se 
trouve simplement que ces deux chemins de localisation selectionnent des node- sets tou- 
jours simultanement vides ou toujours simultanement non vides, ce qui les rend equiva- 
lents du point de vue de la conversion en booleen. 

Exemples de chemins de localisation 

child: :bl oc/descendant: :figure 

selectionne les <f i gure> qui sont des descendants des <bi oc> enfants du nceud contexte. 

child: : bl oc[posi tion( ) =3] /child: :figure[position( )=1] [attribute: :type='gif ' ] 

selectionne les <figure> ayant un attri but "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <bioc> enfant du nceud contexte. 

parent: :node( ) /child: : figure 

selectionne les <figure> enfants d'un nceud quelconque parent du nceud contexte. 

/descendant: :figure[position( ) = 42] 

selectionne la figure qui a la position 42 parmi les descendants dela racinedu document. 
II s'agit done de la quarante-deuxieme <figure> dans I'ordrede lecture du document. 

/child: :doc/chi Id: :chapi tre[position( )=5]/chi 1 d: :section[position( )=2] 
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selectionne la deuxieme <section> enfant du cinquieme <chapitre> enfant de I 'element 
<doc> enfant de la racinede I'arbreX M L. 

I child: :chapitre[ descendant: : note/child: :paragraphe/ 
attribute: :al ignement = "centre" ] 

selectionne les <chapi tre> enfants du nceud contexte, qui ont pour descendants des <note> 

ayant pour enfantS deS <paragraphe> ayant un attri but al ignement egal a "centre", 
/descendant::*: not( child::* ) ] 

selectionne les feuilles de I 'arbre X M L du document source, c'est-a-dire les elements qui 
n'ont pas d'enfant. Sans le predicat, on selectionne tous les elements qui figurent parmi 
les descendants de la racine ; le predicat [ child: : * ] filtrece node-set en ne retenant que 
les elements qui ont au moinsun enfant, quel qu'il soit; le predicat [ note child::* ) ] 
agitdefacon inverse, en ne retenant que les elements qui n'ont aucun enfant. 



Formes courtes des chemins de localisation 

Principe 

Vous I'aurez remarque, XPath est un langage assez verbeux ; e'est pourquoi il existe des 
abreviations standard pour certaines constructions frequemment utilisees. Ces abrevia- 
tions simplifient les ecritures, mais pas la comprehension des expressions un peu compli- 
quees, car el les ont tendance a masquer le detail des relations qui existent entre les 
differents constituants d'une expression, alors que ces details sont indispensables pour 
appliquer I'algorithme de lecture (voir C\e pour la lecture d'un chemin de localisation, 
page 64). Lorsqu'on bute sur une expression diffici lement comprehensible, la premiere 
chose a fai re est done d'eli mi ner toutes les abreviations pour reveni r aux formes completes. 

Ceci etant, il estvrai que dans les expressions usuel les qui neposent aucun problemede 
comprehension, ces abreviations sont les bienvenues. On noteraquel'emploi de la forme 
courte de child: :nom revient a sous-entendre la relation de parente enfant de dans les 
phrases de description d'un chemin de localisation. 



Tableau 2-1 - Abreviations standard 



Forme longue 


Abreviation 


child: : nom 


nom 


child: :* 


* 


attribute: :notn 


@nom 


attribute::* @* 


[positionO = x] 


[X] 


self::node() 


parent: :node( ) 


/descendant-or-self : :node( )/ 


// 
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Exemples de chemins de localisation en formes courtes 

Voici quelques exemples d'utilisation de ces formes courtes ; pour chacune, on donne la 
forme longue equivalente. 

figure 

Forme longue ; 
child: :figure 

selectionne les <figure> qui sont des enfants directs du nceud contexte. 

textO 

Forme longue : 
child: :text() 

selectionne les enfants directs du nceud contexte qui sont des nceuds de type text. 

//figure 
Forme longue : 

/descendant-or-sel f : :node( ) /child: :figure 

selectionne les <figure> qui sont des enfants directs de n'importequel nceud descendant 
de la racine de I'arbreXM L (done selectionne toutes les figures, ou qu'elles se trouvent 
dans le document). Si <figure> est la racine du document, el le est aussi selectionnee, car 
la racine du document est enfant direct de la racine de I'arbre XM L (voir Nceud de type 
root, page 31). 

bloc//figure 
Forme longue ; 

child: :bloc/descendant-or-self : :node( )/child: :figure 

selectionne les <figure> qui sont des enfants directs ou indirects des <t>ioc> enfants du 
nceud contexte. 

bloc[3]/figure[@type = 'gif'][l] 
Forme longue : 

child: : bl oc[position( ) =3] /child: :f igure[position( )=1] 

[attribute: :type='gif ' ] 

selectionne les <figure> ayant un attri but "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <t>ioc> du nceud contexte. 

. ./figure 
Forme longue : 

parent: :node( ) /child: :figure 

selectionne les <figure> du parent du nceud contexte. 
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.//paragraphe 
Forme longue : 

self: :node()/descendant-or-self : :node( )/child: :paragraphe 

selectionne les <paragraphe> qui sont des enfants directs ou indirects du nceud contexte. 

//*[not(*)] 
Forme longue : 

/descendant-or-sel f : : node () /child: :*[not( child: :*)] 

selectionne I esfeui I lesde I 'arbreXM L. Ici laformelongueestplusfacileacomprendre : 
les elements (n'ayant pas d'enfant) enfant de n'importe quel nceud de I'arbre (y compris 
la racine). 

Variantes syntaxiques 

Expressions diverses 

1 1 n'y a que tres peu de possi bi I i tes pour former des expressi ons renvoyant des node-sets : 
on dispose de chemins de localisation, qui sont en eux-memes des expressions renvoyant 
un node-set, de references a des variables contenant un node-set (mais les affectations de 
ces variables ne sont pas du ressort du langage XPath), de parentheses, de I'operateur | 
(reunion ensembliste), et d'appels a des fonctions predefines renvoyant un node-set (a 
savoirunefonction proprement XPath, ido, etdeux fonctionsXSLT uti I i sables dans une 

expression XPath, keyO et document ( )). 

Voici quelques exemples d'expressions manipulant ces divers ingredients : 

(/descendant: :figure[position( ) = 42]) 

renvoie un node-set contenant la quarante-deuxieme <f igure> dans I'ordre de lecture du 
document. Cet exemple a deja ete vu, mais sans les parentheses, qui dans ce cas ne ser- 
vent a rien, mais ne font pas non plus de mal. Quoique... Ces parentheses ne font-el les 
vraiment pas de mal ? Voyez la section Enumeration d'un node-set renvoye par une 
expression, page 71. 

/descendant: :figure | /descendant: : image 

renvoie un node-set contenant reunion de toutes les figures et de toutes les images du 
document. 

/ | documentt 'charteGraphique.xml ' ) 

renvoie un node- set contenant reunion de la racine de I 'arbre du document source et del a 
racine de I'arbre d'un document auxiliaire, contenu dans le fichier 'charteGraphi- 
que.xml 1 . 

/descendant: :figure[ ©type = 'gif ] | $meslmages 
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renvoie un node-set contenant reunion de tous les elements <figure> ayant un attri but 

type egal a "gif" et des elements du node-Set $meslmages. 

Evaluation d'une etape de localisation par rapport a un node-set 
renvoye par une expression 

Nous avons vu a la section Evaluation d'une <?tape de localisation par rapport a un node- 
set, page 63, comment faire pour evaluer une etape de localisation par rapport a un 
node-set. Maisrien n'empeche que le node-set soit renvoye par une expression ; en voici 
quelques exemples : 

document( 'charteGraphique.xml ' )/descendant: :figure[ @type = 'gif ] 

selectionne le node-set des elements <figure> (ayant un attri but type egal a "gif") qui 
sont les descendants de la racine de I'arbre X M L du document auxiliaire contenu dans le 

fiChier "charteGraphique.xml". 

(/descendant: :figure | /descendant: :image)/attribute: :scale 

selectionne les scale qui sont les attri buts des nceuds appartenant a la reunion des node- 
sets /descendant: :figure et /descendant: :image. A noter qu'On aurait pu aUSSi ecrire 

I 'expression : 

/descendant: :*[ self :: figure or self::image ]/attribute: :scale 

qui aurait selectionne le meme node-set. 

$monDocument/chi Id: :chapit re/section 

selectionne les <section> enfants des <chapitre> enfants des elements contenus dans le 

node-Set SmonDocument. 

Notez qu' une expression formeed'un chemin de localisation suivi d'une expression ren- 
voyant un node-set n'a aucun sens : 

I child: :chapitre/section/$monDocument <!-- aucun sens !! --> 
child: :chapitre/(child: :section) <!-- aucun sens !! --> 

Enumeration d'un node-set renvoye par une expression 

Lorsqu'un node-set est constitue par une etape de localisation, il est associe a un axede 
localisation qui est soit direct, soit retrograde. Cela permet de definir dans tous les cas 
des indices de proximite (voir Indices de proximity page 53), et done de donner un sens 
a la notion d'enumeration d'un node-set : un node-set estenumere (quand besoin est) en 
suivant I'ordre des indices de proximite. 

M aissi le node-set est renvoye par une expression quelconque, on perd la notion d'axede 
localisation, done d'indices de proximite, done d'enumeration. Dans ce cas, la regie est 
de choisir arbitrairement I 'ordre de lecture du document pour enumerer les elements. 
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Regie pour definir remuneration d'un node-set 

Deux cas sont a envisager : 

• soitle node-set fait partie d'une etape de localisation ; dans ce cas, un axe de localisa- 
tion est defini, done les indices de proximite sont definis, ettoute enumeration se fera 
suivant I'ordre des indices de proximite ; 

• soit le node-set provient d'une expression X Path qui n'est pas une etape de localisa- 
tion : dans ce cas les enumerations se feront dans I 'ordre de lecture du document. 

Exemple 

Le basculement entre ces deux cas peut etre assez subtil : le standard X Path donne un 
exemple limite qui est assez parlant dece point de vue : 

Enumeration imposee par indices de proximite 

preceding-sibl ing: :figure 

Enumeration par defaut. suivant I'ordre de lecture du document 

(preceding-sibl ing: : figure) 

Dans I e premier cas, on a une etape de localisation, done I 'axe de localisation est deter- 
mine, et les indices de proximite interviennent pour donner I'ordre d'enumeration. 

Dans le deuxieme, I'expression precedente est mise entre parentheses. Cela produit 
I'effet decalculer un nouveau node-set, qui estevidemment identiqueau precedent, mais 
qui n'a pas le statut de node-set faisant partie d'une etape de localisation. II en resulteque 
toute enumeration de ce deuxieme node-set se fera dans I'ordre de lecture du document, 
exactementa I 'inverse du premier cas, puisquel'axechoisi estun axe retrograde. 

Comme nous I'avons dit, cet exemple est un exemple limite : il ne faut pas croire que 
dans I a prati que, on est sans cesse confronts a ce genre de subti lite. M ais il n'est pas mau- 
vais de I'avoir vu, et de se souvenir que ^enumeration d'un node-set depend de facon 
cruciale de la prise en compte ou non d'un axe de localisation. 

Application d'un predicat a une expression renvoyant un node-set 

II est possible d'appliquer un predicate une expression renvoyant un node-set. Cequ'on 
a vu a la section Pr<?dicats, page 57, e'est I 'application d'un predicat a un node-set forme 
lors d'une etape de localisation. La difference, ici, est que le node-set n'est plus neces- 
sairement lie a une etape de localisation, done, si besoin est (notamment si la fonction 
predefinie positionc ) est employee dans le predicat), la regie indiquee a la section pre- 
cedente s'appli que. 

En reprenant I 'exemple limite de la section precedente, on aura : 

preceding-sibl ing: :figure[ positionO = 1 ] 

constitue I e node-set NS des <figure> qui sont des preceding-sibling du nceud contexte; 
dans ce node-set, selectionne la premiere <figure>. Comme I'axe preceding-sibling est 
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un axe retrograde, la figure selectionnee est done la derniere dans I'ordre de lecture du 
document. 

(preceding-sibling: :figure)[ positionO = 1 ] 

constitue le node-set NS des<figure> qui sontdes preceding-sibling du nceud contexte ; 
dans ce node-set, selectionne la premiere <figure>. Commece node-set n'est lie a aucun 
axede localisation, e'est I'ordre de lecture du document qui intervient, et la figure selec- 
tionnee est done la premiere dans I'ordre de lecture du document. 

Voici maintenantd'autresexemples : 

(//paragraphe | //noteBasDePage)[ child: :text( ) 

[ contains( self : :node( ) , "predicat" ) ] 

] 

selectionne tous les paragraphes ou notes de bas de page du document, pourvu qu'ils 
aient au moins un enfant de type text qui contienne « predicat » dans un noeud qui soit 
self. Ou encore, en simplifiant les redondances, pourvu qu'ils aient au moins un enfant 
de type text qui contienne « predicat ». A utrementdit: selectionne tous les paragraphes 
ou notes de bas de page qui parlent de predicat. 

$meslmages[@type = 'gif'] 

selectionne les elements du node- set reference par la variable $mesimages, ayant un attri- 

but type egal a 'gif'. 

$p[ countt self::node() | $q ) = countt $q ) ] 

selectionne les elements du node-set reference par la variable $p, qui appartiennent aussi 
au node- set reference par la variable $q. C 'est la fameuse expression qui permetdecalcu- 
ler intersection dedeux node-sets : voir Appartenance et test d Inclusion, page 44. 
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Au coeur du langage XSLT 



Ce chapitre a pour but de rendre intelligible le fonctionnement de ce langage, non pas en 
le montrant en action, car le voir fonctionner n'explique rien, mais en al I ant au cceur des 
mecanismes qui regissentson comportementdynamique. 

Pour cela, nous presenterons la structure generaled'un programme XSLT, qui metclaire- 
ment en evidence les deux piliers du langage, que sont le motif et le modele de transfor- 
mation ; puis nous demonterons le moteur de transformation, en faisant ressortir les 
etapes du processus general de traitement. Ensuite nous revisiterons en detail, d'abord 
les motifs et la concordance de motifs, puis les deux modeles de transformation fonda- 
mentaux, represents par les instructions xsi :vai ue-of et xsi :appiy-tempiates, dont la 
comprehension aboutit de facto a celle des autres instructions de transformation, qui ne 
sont rien d'autre que des variantes polymorphes et contingentes de ces deux-la, sans rien 
de nouveau dans I 'essence memedes mecanismes. 



Structure d'un programme XSLT 

Un document (ou programme) XSLT est un document X M L, dont la racine est I 'element 

stylesheet, etdont ledomaine nominal est "http://www.w3.org/1999/XSL/Transform", 

general ementabrege en "xsi:". 

Un programmeXSLT a done I'allure suivante : 

<?xml version="1.0" ?> 

<xsl : stylesheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transform"> 
</xsl :stylesheet> 

L'abreviation de domaine nominal "xsi:" est eel I e qui est traditionnellement utilisee. 
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M ais bien sfir, comme toute abreviation de domaine nominal, die n'est qu'une abrevia- 
tion possible, et I 'on est libred'en choisir une autre (par exemplexsit:), du moment que 
le domaine nominal restelememe: 

<?xml version="1.0" ?> 

<xslt: stylesheet xmlns:xslt=" http://www.w3.org/1999/XSL/Transform"> 
</xslt:stylesheet> 

Remarque 

La declaration de ce domaine nominal etant obligatoire, tous les elements propres a XSLT seront done neces- 
sairement prefixes par I'abreviation de domaine nominal choisie ; autrement dit, toute balise dont le nom ne 
serait pas prefixe par "xsi : " (en supposant que e'est celle-la que Ton a choisie) serait consideree par le proces- 
ses XSLT comme du XML ordinaire n'ayant rien a voir avec XSLT. 

Comme un programme XSLT est un document XML, tous les aspects lexicaux sont du 
ressort d'XML et non d'XSLT : la syntaxe pour les noms d'elements, d'attributs, les 
caracteres interditsdans les valeurs d'attributs, etc., toutceci est determine par le langage 
X M L et non par X SLT proprement dit. 

Elements XSLT, instructions, et instructions de premier niveau 

Un element XSLT est un element XML dans le domaine nominal de XSLT, done de la 
forme <xsi :xxx>, si toutefois I'abreviation choisie est bien xsi : (ceque nous supposons 
etre vrai partout dans la suite). 

Une instruction est un element XSLT. 

Certaines instructions sont des instructions de premier niveau : ce sont des elements 
XSLT enfants directs de la racine <xsi :styiesheet>. 

Remarque 

Le standard XSLT 1 .0 parle de « top-level element » (que nous avons traduit par « instruction de premier 
niveau », puisque pour nous, « element XSLT » et « instruction » sont synonymes), et emploie le mot « instruc- 
tion » dans la grammaire XSLT, mais sans vraiment le definir. 

L'alluregeneraled'un programmeXLST est done celle-ci : 

<?xml version="1.0" ?> 

<xsl : stylesheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transform"> 
<!-- instructions de premier niveau --> 

<!-- fin des instructions de premier niveau --> 
</xsl :stylesheet> 

Les differentes instructions sont assez peu nombreuses, et nous les verrons au fur et a 
mesure que nous en aurons besoin dans la suite de ce livre ; la plus importante d'entre 
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elles, <xsi rtempiate match=" . . .">est celle qui permet de definir une regie de transfor- 
mation, etc'estbien sur parellequ'il faudra commencer. 

Le standard XSLT 1.0 donneau tout debut un exemplede programme XSLT tres varie en 
instructions : 

<xsl :stylesheet 
version="1.0" 

xmlns :xsl="http: //www.w3.org/1999/XSL/Transform"> 

<xsl: import href="..."/> 

<xsl :include href="..."/> 

<xsl : strip-space el ements=" ..."/> 

<xsl :preserve-space elements^" . . . "/> 

<xsl:output method=" . . . "/> 

<xsl:key name="..." match="..." use="..."/> 

<xsl :decimal -format name=" ..."/> 

<xsl :namespace-alias 

styl esheet-pref ix=" ..." 
result-prefix=" . . . "/> 

<xsl :attribute-set name="..."> 

</xsl :attribute-set> 

<xsl : variabl e name=" ...">.. .</xsl : variable> 
<xsl :param name=" ...">.. .</xsl :param> 

<xsl :template match="..."> 

</xsl :templ ate> 

<xsl : tempi ate name="..."> 

</xsl :templ ate> 

</xsl :stylesheet> 

II nes'agitpasici d'expliquer a quoi correspondent ces instructions, maissimplementde 
prendre contact avec I 'allure d'un programme XSLT. 

Voici un autre exemple, moins riche en variete d'instructions, mais complet, sans points 
de suspension : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='html ' encodings' ISO-8859-1 ' /> 



<xsl :template match="/"> 
<html> 
<head> 
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<ti tleXxsl : val ue-of sel ect=" /Concert /Entete"/X/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl : tempi ate match="Entete"> 

<p> <xsl : val ue-of select=" . "/> presentent </p> 
</xsl :templ ate> 

<xsl : tempi ate match="Date"> 

<H1 al ign="center"> Concert du <xsl :value-of select="."/> </Hl> 
</xsl :template> 

<xsl : tempi ate match="l_ieu"> 

<H4 al ign="center"> <xsl : val ue-of select="."/> </H4> 
</xsl :template> 

<xsl : tempi ate match="Ensemble"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :val ue-of select="."/> </H3> 
</xsl :templ ate> 

</xsl :stylesheet> 

De toutes les instructions, la plus importante, eel le qui caracterise le plus le langage 
XSLT, e'est I 'instruction <xsi : tempi ate matcn=". . . ">, qui definit cequ'on appelle une 
regie de transformation : XSLT est un langage de transformation base sur des regies de 
transformation. 

Regies de transformation 

XSLT est un langage declaratif, a la maniere de Prolog. On ne decrit pas des actions a 
enchainer en sequence, mais des regies de transformation a appliquer suivant les cas qui 
se presentent ; de sorte qu'en general, I'ordre dans lequel ces regies sont enoncees n'a 
aucune influence sur le fichier resultat. 

Un processeur XSLT traite un document XML en parcourant les elements de I'arbre 
XML correspondant, et en appliquant a certains d'entre eux une regie de transformation 
choisie parmi I 'ensemble des regies constituant le programme XSLT. 

Un programme XSLT se compose done essentiellement d'une serie de regies, chaque 
regie etant constitute de deux parties : 

• Un motif (pattern). Exprime en X Path, il ditsi I'elementcourantestou non atraiter. 
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• Un modele de transformation (template), qui dit par quoi remplacer I'element cou- 
rant, dans le cas ou il correspond au motif. 

Remarque 

Pour etre complet, ajoutons qu'un programme XSLT peut aussi integrer, en tant qu'instruction, des elements plus 
proches de la programmation classique, qui s'apparentent aux variables et aux fonctions, et permettent de 
realiser des algorithmes. De ce point de vue, XSLT est un langage fonctionnel pur. Pour les connaisseurs, disons 
qu'il ressemble a un Caml hyper-light (ce qui fait de XSLT un langage tenant a la fois de Caml et de Prolog). Pour 
les autres, disons en un mot qu'un langage fonctionnel est un langage de programmation dont I'une des carac- 
teristiques (en fait la seule qui nous interesse pour comparer a XSLT) est que la notion de variable dont la valeur 
peut evoluer au cours du temps n'a aucun sens. On est done dans un monde extremement different de celui de 
C ou de Java : il ne faut surtout pas projeter sur XSLT les connaissances qu'on peut avoir de la notion de variable 
ou de fonction tirees de la pratique de C ou Java. 

Mais XSLT n'est pas encore un langage de plus pour I'algorithmique : il y en a deja suffisamment comme ?a sur 
le marche ; e'est un langage de manipulation d'arbres, et en tant que tel, ce sont les regies XSLT (avec leur motif 
et leur modele de transformation) qui sont essentielles, et non pas les possibilites offertes dans le domaine de la 
programmation algorithmique. Cela ne veut d'ailleurs pas dire qu'elles sont inutiles ; elles sont meme parfois 
indispensables, mais n'ont de sens que comme complement a I'essentiel (la manipulation d'arbre). 



Forme d'une regie XSLT 

Une regie XSLT (ou regie de transformation), constitute d'un motif et d'un modele de 
transformation, se presente sous la forme d'une instruction <xsi :tempiate> dont I 'attri but 
match fournit le motif, et dont les nceuds enfants constituent le modele de transformation : 

<xsl : tempi ate match=" . . .pattern. . . "> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Le motif, ou pattern, fourni en tant que valeur de I 'attri but match, s'exprime sous la 
forme d'une expression X Path verifiant des contraintes parti culieres. 

Note 

Lexistence de ces contraintes ne doit pas suggerer que XPath est un langage mal congu car trop puissant pour 
I'usage qu'on en a ; en effet, XPath, en tant que langage general d'expressions designant des sous-arbres dans 
un arbre XML, est utilise aussi bien pour XSL que pour XPointer (et bientot XQuery). La puissance expressive de 
ce langage n'est done pas forcement utilisable en totalite dans tous les contextes. 

Modele de transformation 

L e modele de transformation decrit ce par quoi il faut remplacer le sous-arbre que le motif 
designe (ou les sous-arbres si I e motif en designe plusieurs). Ce peut etre du texte simple : 



<!-- modele de transformation --> 
bla bla ... 
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bla bla ... 

<!-- fin du modele de transformation --> 

Ce peut etre aussi du texte agremente de valeurs tirees de sous-arbre(s) designe(s) par 
une expression X Path quelconque (ici, pasde restriction sur I'emploi deXPath) : 

<!-- modele de transformation --> 
bla bla ... 

ici, une instruction XSLT qui va provoquer 1 'insertion, 

a cet endroit, de la valeur de l'attribut "nom" de 1 'element <personne> 

qui se trouve a tel endroit dans 1'arbre XML du document 

bla bla ... 

<!-- fin du modele de transformation --> 

B ien sur, on peut deja se douter que la valeur de l'attribut nom de I 'element <personne> se 
trouvant a tel endroit dans le document XM L sera exprimee sous la forme d'une expres- 
sion XPath de la forme : 

.../.. ./personne/attribute: :nom 

Comme toute la puissance de XPath est ici utilisable, on imagine facilement qu'il y a 
beaucoup d'autres possibility : recuperation du contenu d'un element, evaluation d'une 
fonction sur un ensemble d'elements, et tout autre calcul du meme genre, pourvu qu'il 
soitexprimable en XPath : 

<!-- modele de transformation --> 
bla bla ... 

inserer ici le contenu de 1 'element <description> qui se trouve a 
tel endroit dans 1'arbre XML du document 
bla bla ... 

<!-- fin du modele de transformation --> 

Ou encore : 

<!-- modele de transformation --> 
bla bla ... 

inserer ici la somme des valeurs des attributs "prix" 
des elements <produit> qui se trouvent a 
tels et tels endroits dans 1'arbre XML du document 
bla bla ... 

<!-- fin du modele de transformation --> 

Par ailleurs, le texte peut lui-memeetre balise en XML (par exemple en XHTML ou 
HTML4) : 

<!-- modele de transformation --> 

<BR/> bla bla ... 

<P> 

inserer ici la somme des valeurs des attributs "prix" 

des elements <produit> qui se trouvent a 

tels et tels endroits dans 1'arbre XML du document 

</p> 

<Hl>bla bla ...</Hl> 

<!-- fin du modele de transformation --> 
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II fautrappelerici que le balisage eventuel enXML (ou varianted'XM L) du texteconsti- 
tuant le modele de transformation doit respecter la structure de document bien forme 
imposee par le standard XM L. II est done impossible de baliser le texte en HTM L ordi- 
naire, a cause des balises comme <t>r>, <p>, <hr>, etc. qui n'ont pas necessairement de 
balisedefermeture associee. 

La raison de cette restriction est fort simple : un programme XSL est avant tout un docu- 
ment XML bien forme; lorsqu'on lance le processeur XSLT, le document XSL est 
d'abord I u de facon standard par un parseur X M L , qui ne fait aucune difference de traite- 
ment entre les balises prefixees par -xsi :" et les eventuelles autres. Une fois construit 
I'arbreXML du document XSL, le processeur XSLT entre en action ; il parcourt I'arbre 
XML obtenu, en interpretant les balises prefixees par "xsi :■ comme autant destruc- 
tions, et en considerant les autres comme des bribes de donnees. 

Modele de transformation litteral 

Un modelede transformation litteral estun model ede transformation qui necontientque 
du texte et des elements XM L en dehors du domaine nominal de XSLT. C'est done un 
model ede transformation qui ne contient pas d'instruction XSLT. Un element XM L non 
XSLT qui figure dans un model ede transformation s'appelle un element source litteral. 

Exempl e 

<xsl : tempi ate match=" . . .pattern. . . "> 

<!-- modele de transformation 1 i tteral --> 

Detail du rez-de-chaussee : 

<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 
</RDC> 

<!-- fin du modele de transformation litteral--> 
</xsl : tempi ate> 

Ce model ede transformation est litteral, parcequ'il ne contient que du texte etun element 
XML non XSLT (<rdc>, ettoutesa descendance), qui est done un element source litteral. 



Un premier exemple de programme XSLT 

Apres ce survol tres rapide de la forme generale d'une regie XSLT, nous allons mainte- 
nant revenir sur I'exemple vu un peu plus haut, afin de ne pas le quitter sans savoir ce 
qui I peut produi re comme resultat. 
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Cet exemple, visible a la figure 3-1, n'est pas destine a expliciter le principe de fonction- 
nementdu langageXSLT, car malgre son apparente simplicite, il esttrop complique pour 
un debut ; il ne faut done s'attacher qu'a apprehender la structure general e, sans s'arreter 
sur le detail des divers constituants. 



Concert.xsl 



<?xml version-'l. 0" encoding="UCS-2"?> 

<xsl:stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version-!. 0"> 
<xsl:output method-html' encoding='ISO-8859-l' /> 



<xsl:template match="/"> 
<html> 
<head> 
<title> 

<xsl:value-of select="/Concert/Entete"/> 

</title> 

</head> 

<body bgcolor-'white" text="black"> 

<xsl:apply-templates/> 
</body> 
</html> 

</xsl:template> 

<xsl:template match-'Entete" 

<pxxsl:value-of select="."/> 
presentent</p> 

</xsl:template> 

<xsl:template match="Lieu"> 
<H4 align="center"> 
<xsl:value-of select-'. "/> 
<H4> 

</xsl:template> 



Netscape: «Les Concerts d"Anacreon» ED S 



«Les Concerts d'Anacreon» presenters 

Concert du Jeudi 17 
anvier 2002, 20H30 

Chape lie des Ursoles 

r- rise ruble «A deux violes esgal 

/ .Oeuvres de 

M. Marais^D. Castello, F. Rognoni 

^HP= / 




<xsl:template match="Date"> 

<H1 align="center"> 

Concert du <xsl:value-of selec^"."/> 

<H1> 
</xsl:template> 

<xsl:template match-'Ensemble"; 
<H2 align="center"> 
Ensemble 

<xsl:value-of select-'. 7></H 2 
</xsl:template> 

<xsl:template match-'Composit? 

<H3 align— 'center">y 

Oeuvres de <br/> 

<xsl:value-of select-'. "/> <yH3> 
</xsl:template> 

</xsl:stylesheet> 



:.xml 



^?xml version-!. 0" encoding="UCS-2" standalone="yes"?> 
<Concert> 

<Entete>«Les Concerts d'Anacreon» <7Entete> 
<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>C hapelle des Ursules</Lieu> 

<E nsemble> «A deux violes esgales» </E nsemble> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
<Compositeurs> 

<yConcert> 



Figure 3-1 

U n exemple de transformation XM L vers HTM L 
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M algre tout, il reste suffisamment simple pour qu'on puisse intuitivement entrevoir de 
quelle maniere il transforme en HTM L le fichier XML propose en entree. 

C'est ainsi qu'en observant le fichier XM L donne et le resultat obtenu, on imagine bien 
que la transformation XSL consistetout simplementa deshabiller letextedeses di verses 
balisesXML pour le rhabiller de balises HTM L (XHTML plus exactement, pourconser- 
ver la structure de document bien forme), en respectant I'ordre dans lequel les elements 
XML apparaissent dans le fichier donne. Notez bien qu'il ne s'agit pas de I'ordre dans 
lequel les regies sont donnees : voyez en particulier le croisement entre la regie pour le 
lieu etla regie pour la date. 

Rien de bien extraordinaire dans tout cela, une simple feuille de style CSS pourrait en 
faire autant. Quoique ... Aviez-vous remarque que le contenu de I'element <Ent§te> 
intervient deux fois dans le resultat, une fois comme titre de la fenetre du navigateur, et 
une fois dans le texte proprement dit ? 

Lancement du processeur XSLT 

A titre indicatif, et pour fixer les idees, voici la commande (avec Saxon) qui a permis 
d'obtenir le resultat ci-dessus : 

Ligne de commande (d'un seul tenant) 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 

com. icl .saxon. Stylesheet -o Concert.html Concert. xml Concert. xsl 



Principe de fonctionnement d'un processeur XSLT 

Le principede fonctionnement d'un moteurXSLT est important a comprendre, caril est 
normalise, done parfaitement previsible ; ecrire(ou concevoir) une feui I lede style XSLT, 
c'est done prevoir le comportement du processeur XSLT face a la feuille de style qu'on 
se prepare a lui proposer. 

Note 

Cela ne veut pas dire que le resultat produit par un programme XSLT soit toujours facile a prevoir dans ses 
moindres details, Mais en fait, une divergence entre le resultat obtenu et ce que I'on imaginait obtenir peut 
passer plus ou moins inapercue :parexemple, une mauvaisegestion des espaces blancs (espaces, tabulations, 
sauts de lignes) estsans importance pour la generation d'un fichier HTML, mais plus problematique pour celle 
d'un fichier RTF. Neanmoins, comme le comportement du processeur XSLT est bien sur deterministe, toutfinit 
pars'expliquer, meme si c'est parfois un peu ardu. 

L'ecriture de feui I les de style par analogie et recopie de feui I les de style existantes, sans 
comprehension reel I e du fonctionnement sous-jacent, est naturellement possible, mais 
cela reste I i mite a des feui I les de style simples, basees sur des structures simples et en 
nombre I i mite, qui finissent par devenir familieres. 
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Le but de cette section est de fournir une representation conceptuelle du model e de trai- 
tement d'un moteur XSLT. Bien que conceptuelle, cette representation est conforme au 
standard W3C, mais ce n'est qu'une representation : rien n'oblige (mais rien n'interdit 
non plus) les auteurs de processeurs XSLT a respecter a la lettre cette description dans 
leur implementation ; il suffit qu'ils la respectent dans leprincipe, du moment que globa- 
lement, leur processeur fonctionne comme nous allons I'expliquer maintenant. 



Construction - serialisation 

Le processeur XSLT opere sur un arbreXM L, construit au lancement du processeur par 
un parseur XM L, a partir d'un fichier XML. Ce processus s'appelle la construction de 
I'arbre ; le processus inverse, qui permet I'obtention d'un fichier X M L a partir d'un arbre 
XML, s'appelle la serialisation (voir figure 3-2). 



Figure 3-2 

Construction 
Serialisation. 



Document XML 



<Concert> 

<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>C ha pelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford <VNom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
</lnterpretes> 
</Concert> 

Construction 



Serialisation 



Date 



^root 
^Concert 

Lieu Interpretes 



janvi i e 1 r 7 2002, des Pe " e mterprete Interprete 

20H30 Ursules # # 

Norn Instrument Nom Instrument 



Jonathan Basse Silvia Basse 
Dunford de viole Abramowicz de viole 

Arbre XML du document 
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Ces deux representations document/arbre sont equivalentes, de sorte que toute operation 
sur I'arbre XML peut se transposer en une operation equivalente sur le document, et 
reciproquement. 

Les trois phases du processus complet 

Le processeurXSLT operesur I'arbreXM L du document, appele arbre source, dont les 
elements sont des na?uds source. La transformation consiste a produire un nouvel arbre 
XML, appele arbre resultat. 

La serialisation de cet arbre resultat produit un document resultat qui peut etre un docu- 
ment XM L, un document HTM L 4 ou X HTM L, voire un simple texte non balise. 

Le processus complet est done un enchainement de trois operations : construction, trans- 
formation, serialisation (voir figure 3-3). 

Specification d'une transformation 

Une transformation XSLT est une suite d'operations elementaires sur un arbre XML, 
produisant un nouvel arbre XML. Une transformation XSLT peut done etre specifiee 
d'une facon tres naturelle et directe en termes d'operations sur un arbre. Mais etant 
donne I 'equivalence des representations arbre/document, il est egalement tout a fait pos- 
sible de la specifier en termes d'operations sur un document. 

Par ailleurs, le processeur X SLT n'effectue jamais de modification sur I 'arbre source ori- 
ginal : il secontentedeconstruireun nouvel arbre, de sorte que les seules operations ele- 
mentaires utiles sont eel les qui consistent a grefferun nouveau morceau d'arbre a I'arbre 
en cours de construction. Transposes a la representation par document, ces operations 
de greffes se reduisent a des concatenations de fragments de documents ou d'inclusions 
d'un fragment de document dans un autre. 

Note 

La concatenation de deux documents donnes estun nouveau document, obtenu en les mettant bout a bout dans 
I'ordre ou ils sontdonnes. 

Or il se trouve que d'un strict point de vue redactionnel, il est beaucoup plus simple de 
s'exprimer en termes de manipulation de document qu'en terme de construction d'arbre 
(e'est I 'inverse en programmation, ou il est beaucoup plus facile d'exprimer une transfor- 
mation d'arbre qu'une manipulation de document). C 'est pourquoi dans toute la suite, 
nous avons d«?1ib<?r«?mentfait le choix d'exprimer les effets des transformations et des ins- 
tructions XSLT en termes de construction de documents a partir de fragments de docu- 
ments, et non en termes de construction d'arbres a partir de sous-arbres. 



Principe de fonctionnementd'un processeurXSLT 




Chapitre 3 



Modele de traitement 

Nous allons maintenantvoir un resume synoptiquedu modele de traitement d'un proces- 
seurXSLT, qui sera decline en plusieurs etapes. Chaqueetapefait reference a la suivante, 
sauf la derniere qui peuteventuellement revenir recursivement en arriere. 

Ce resume synoptique est assez general, car il ne rentre pas dans le detail de I'effet de 
chaque i nstructi on X SLT. 1 1 se contente de decri re I e mecanisme ; mais plus loin (Les ins- 
tructions de transformation, page 127), nous verrons dans le detail chaque instruction 
importante de X SLT, et nous aurons I 'occasion de preciser finement le deroulement de ce 
model ede traitement pour chacunedeces instructions. 

Traitement du document XML source 

Au depart du traitement, une liste de nceuds source initiale est constitute, ne contenant 
que la racine de I'arbre XM L du document a traiter (figure 3-4). Le traitement du docu- 
ment consiste a traiter la liste de nceuds source initiale. 



Figure 3-4 

Traitement du 
document XM L 



<Entete> «Les Concerts d'Anacreon» <Entete> 
<Date>Jeudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules<Lieu> 



<html> 
<head> 

<META http-equiv="Content-Type" content-'textyhtml; 
charset=ISO-8859-l"> 



<titfe> «Les Concerts d'Anacréon» 
<title> 
</head> 

<body text="black" bgcolor="white"> 



source. 



<Ensemble> «A deux violes esgales» <JE nsemble> 



<Campositeurs> 

M. Marais, D. Castello, F. Rognoni 
<Compositeurs> 



<p>«Les Concerts dAnacréon» 
présentent <p> 



DocumentXML a traiter 



<H1 align="center"> Concert du J eudi 17 J anvier 2002, 
20H30</H1> 



<H4 align="center">Chapel[e des Ursules</H4> 




<H2 align="center"> Ensemble «A deux violes 
esgales» <H2> 



<H3 align-"center"> Oeuvres de <br> 



</body> 
<html> 



Rognoni 



Document resultat 



M Marais, D. Castello, F 



Arbre XML du document a traiter 




Liste a traiter 



root 



Traitement 
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L e document final obtenu lors de ce traitement est le document resultant du traitement de 
cette liste. 



Traitement d'une liste de noeuds source 

Le traitement d'une liste de noeuds source consiste a traiter separement chaque noeud 
source dans I'ordre ou il apparait dans la liste (figure 3-5), ce qui produit en resultat 
autant de fragments de documents qu'il y a de noeuds source a traiter. 

L e document resultat du traitement de la liste est la concatenation des fragments de docu- 
ments obtenus separement. 



Traitement 
(l)+(2)+...+(n)+(n+l) 



Fragment de document 
resultat du traitement de la 
liste de noeuds 



Liste de noeuds a traiter 

Noeud n 



Noeud 1 Noeud 2 
• • 



Traitement Traitement 
d'un noeud d'un noeud 
(1) (2) 



Traitement 
d'un noeud 
(n) 



T T T 

FD 1 - FD 2 — FD n 



Fragments de documents 

Figure 3-5 

Traitement d'une liste de nceuds source 



Fragments 
de 

documents 
concatenes 



Concatenation 
(n+1) 




Traitement d'un nceud source membre d'une liste de nceuds source 

Le traitement d'un noeud source consiste a rechercher, parmi I'ensembledes reglesXSLT 
definies dans le programme XSLT, celle dont le motif correspond au noeud traite, puis a 
appliquer cette regie, relativement a un noeud courant qui est le noeud traite, eta une liste 
courantequi est I a liste de noeuds source. 

• Si aucune regie n'est trouvee, une regie par defaut, possedant un modele par defaut, 
est appliquee. 

• Si plusieurs regies sont trouvees, un algorithme de calcul de priorite permet normale- 
mentd'en selectionner uneetuneseule(sinon le programme XSLT est incorrect). 
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L 'application de cette regie (relativement a son nceud courant et a sa liste courante), 
consiste a instancier le modele de transformation associe (relativement au meme noeud 
courant et a la meme liste courante), ce qui produit un fragment de document qui est le 
resultat du traitement du noeud source (figure 3-6). 



I 



P rogramme XSLT 
Motif 1 

Modele 1 



t 



„ _ concordance i 

CX >• Motif 2 



Liste contexte 



Nceud a traiter 
(Nceud contexte) 



Modele 2 



Motif n 



Modele n 



Figure 3-6 

Traitement d 'un naud source 



instanciation 



FD 



Fragment de document 



Remarque 

L'experience montre que la liste courante intervient assez rarementdans I'application de cette regie : on pourra 
done, en premiere lecture, ignorerson existence, etfaire comme s'il n'en n'etaitpas question. 



Nceud courant - Nceud contexte 

II est souvent question, en XSLT, de nceud courant etde nceud contexte. II peut etre tentantde confondre ces 
deux notions, d'autant plus que la plupartdu temps, nceud courant et nceud contexte designent le meme nceud. 
Neanmoins ce sontdeux notions differentes. 

La notion de nceud contexte intervient dans revaluation d'une expression XPath : une expression estevaluee 
relativement a un nceud contexte. 

La notion de nceud courant intervient dans Pinstanciation d'un modele de transformation : un modele est instan- 
cie relativement a un nceud courant. 
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Or, dans ce processus d'instanciation, il est frequent qu'une expression XPath soita evaluer : son evaluation se 
faitalors relativementa un nceud contexte qui estle nceud courant(ce qui explique pourquoi il peutetre tentant 
deconfondre nceud contexte et nceud courant) ;mais si cette expression contientun predicatfiltrantun node-set 
aplusieurs elements, le predicat sera evalue pourchacun de ses elements, qui seronttemporairement eta tour 
de role le nceud contexte de revaluation, alors que le noeud courant, lui ne change pas (ce qui explique pourquoi 
il ne faut pas confondre nceud contexte et nceud courant). 

En resume, pourne pas se tromper, mieux vauttoujours parlerde nceud courant pourun modele de transforma- 
tion etde nceud contexte pourune expression XPath. 

En deuxieme lecture, on pourra se reporter a la Remarque, page 191, qui detaille un peu plus precisement le 
processus devaluation d'un predicat. 

Instanciation d'un modele de transformation relativementa un noeud courant 
et une liste courante 

L'instanciation d'un modele de transformation consiste a obtenir un fragment de docu- 
ment a partir du modele. Pour ce faire, tout ce qui est texte brut ou texte X M L en dehors 
du domaine nominal deXSLT (general ementdesigne par le prefixe "xsi :") est conserve 
tel quel lors de l'instanciation. Tout le reste consiste en des elements XSLT (<xsi:xxx> 
. . .</xsi :xxx>) qui sont remplaces par leur valeur, qui peut dependre du nceud courant, 
et meme parfois de la liste courante (par exemple lorsque I'une de ces valeurs est la 
valeur numeriquedu numero d'ordredu nceud dans sa liste) ; s'ils n'ont pas de valeur, ils 
sont remplaces par rien (c'est-a-dire sont supprimes: rien est la valeur de remplace- 
ment). 

Instruction - Execution d une instruction 

Dans un modele de transformation, un element XSLT de la forme <xsi:xxx> ... </xsi :xxx> s'appelle une 
instruction. Lors de l'instanciation d'un modele de transformation, ses instructions sont executees. L'execution 
d'une instruction consiste a la remplacer par sa valeur, dans le fragment de document resultat produit par 
l'instanciation du modele de transformation. On peut done parler aussi d'instanciation d'une instruction. 

L'ordre temporel d'instanciation des instructions n'est pas forcement I'ordre sequentiel de leur apparition dans le 
modele ; d'ailleurs on pourrait tres bien imaginer qu'elles soient executees dans un ordre aleatoire (ou bien 
toutes en meme temps, surun ordinateur multi-processeurs). Si a ce stade, cela vous para it incroyable, reportez 
vous a la figure 3-7, oil I'on voitclairementque chaque instruction estresponsable de la creation d'un boutde 
texte qui vientse mettre asa place dans le fragment de document resultat : peu importe dans quel ordre tempo- 
rel les petits bouts de texte sontinseres dans le fragment de document resultat, du moment que I'ordre spatial 
dans lequel ils apparaissentrespecte I'ordre spatial des instructions dans le modele. 

L'evaluation de I 'Une des deUX instructions XSLT <xsl :apply-templates> OU <xsl :for- 

each> (et ce sont les deux seules) produit une nouvelle liste de nceuds source ; cette liste 
est alors recursivement traitee : comme toute autre liste de nceuds source, el I e subit le 
traitement standard d'une liste (voir Traitement d'une liste de n«uds source, page 88), et 
la valeur de instruction <xsi :appiy-tempiates> ou <xsi : for-each> est alors egale au 
fragment de document obtenu en tant que resultat du traitement de cette liste (figure 3-7). 
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Modele 



Texte ordinaire 



<xsl:xxx> 
</xsl:xxx> 



<xsl:apply-templates /> 



genere 

f 

Liste de noeuds a trailer 

Nceud 1 Nceud 2 Nceud n 



Traitement Traitement 
d'un nceud d'un nceud 



Traitement 
d'un nceud 



FD 1- FD 2 — FD n 

Fragments de documents 

Figure 3-7 

I nstanci ati on d'un modele de transformation 



Fragment de 
document resultat 



recopie 



Texte ordinaire 



Texte resultat 



rem plac e par 



FD 1 
FD 2 



FD n 



Concatenation 



Motifs (patterns) 

Un motif est une expression qui, evaluee par rapport a un certain nceud contexte, designe 
un certain ensemble denceudsde I 'arbreX M L d'un document. 

Rappelons que le motif est la valeur de I'attribut match dans la definition d'une regie 
X SLT, et que cet attri but doit representer une expression X Path (verifiant une contrainte 
particuliere qui sera explicitee un peu plus loin). 
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Donnons tout de suite un exemple : 

<xsl :template match="child: : Theatre/child: :*"> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Cet exemple s'applique a ce fichier XM L : 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Saison> 

L'expression child: :Theatre/chiid: :* veut dire « tous les elements X M L , qui sontdes 
fils de I 'element Theatre, qui est un fils de». Ce qui ne veut pas dire grand-chose, la 
phrase s'interrompant brutal ement sans qu'on sache la fin de I'histoire. En fait, le motif 
ne peut rien direde plus, et le renseignement qui nous manque, c'est le nceud contexte. 

II nefaut done jamais oublier qu'un motif a base de chemin de localisation relatif, e'est- 
a-dire ne commencant pas par un «/ » (voir Chemins de localisation, page 62), ne peut 
etre evalue que par rapport a un noeud contexte donne. Dans notre cas, si I 'on prend le 
nceud <saison> comme noeud contexte, on peut alors evaluer completement le motif, qui 
designe I 'ensemble des elements qui sontdes fils d' un element <Theatre>, qui estun fils 
d'un element <saison> (voir figure 3-8). 

Le meme motif peut tres bien donner un ensemble vide, si on I'evalue avec un autre 
noeud contexte. Ce sera le cas, par exemple, si I'on prend I'un des deux noeuds <Theatre> 
comme noeud contexte, car il n'existe aucun element qui soit fils d'un element <Theatre> 
lui-meme fils d'un element <Theatre> (voir figure 3-9). 

Concordance de motifs 

Un noeud N de I'arbre XML etant donne, et un certain noeud contexte C etant ensuite 
choisi, si devaluation du motif par rapport au noeud contexte C donne un ensemble qui 
contient N , alors on dit qu'il y a concordance du motif avec le noeud N (voir figure 3-10). 
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Figure 3-10 

Concordance de motif. 
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La chose a remarquer ici, est que contrairement a ce que I'on pourrait imaginer, la 
concordance entre un nceud N et un motif est obtenue des lors que I'ensemble de nceuds 
determine par devaluation du motif contient N : il n'est pas necessaire que cet ensemble 
se reduise au seul element N . 

Recherche de la concordance de motifs (pattern matching) 

Nous venons de voir a quelle condition il y a concordance entre un nceud N et un motif, 
un nceud contexte C etant donne. 

Nous allons maintenant voir comment le moteur XSLT effectue la recherche de concor- 
dance de motif, ou pattern matching. 

Le probleme est que dans ce processus, le nceud contexte C n'est plus donne : le but est 
alors precisement d'en trouver un. 

Ce qui est donne, maintenant, c'est le motif et le nceud N ; charge au moteur XSLT de 
determiner si le motif Concorde avec ce nceud N. 

II peut prendre un nceud C au hasard dans I'arbreXM L, et I'utiliser comme nceud con- 
texte dans devaluation du motif ; si cela donne la concordance du motif avec le nceud N 
en cours d'examen, c'est gagne, il a la reponse. M ais sinon, c'est toujours I'incertitude : 
peut-etre qu'en choisissant un autre nceud C on aurait la concordance, mais peut-etre 
qu'il n'existe aucun nceud dans I'arbre XM L, qui pris comme nceud contexte, donne la 
concordance... 

Comment savoir ? 

U ne premiere idee, evidente, consisterait a effectuer le test de concordance en explorant 
I'un apres I'autre tous les nceuds de I'arbre, et en prenant a chaquefois le nceud courant 
comme nceud contexte pour evaluer le motif : des que I'on a trouve un nceud qui donne la 
concordance, on peut arreter. 

Le probleme est que s'il n'y pas concordance, on ne le sait qu'apres avoir teste infruc- 
tueusement chaque nceud de I'arbre ! Et meme s'il y a concordance du motif avec le 
nceud N, on aura probablement commence la serie detests avec des nceuds contexte tres 
eloignesdu nceud N, avec unefaible probability d'obtenir la concordance, a moinsque le 
motif soit vraimenttres bizarre et complique, mettant en jeu des relations de parente tres 
eloignees entre le nceud N et le nceud contexte qu'il fall ait trouver... 

En fait, tout le probleme est la : pourquoi ecrire des motifs tres bizarres et compliques ? 
II nefaut pas oublier que le but, dans I 'ecriture d'un motif, est si mplementde designer un 
certain nceud, ou une famille de nceuds, sur lesquels on veut qu'une certaine regie 
s'applique. 

Dans ces conditions, entre deux motifs qui pourraient egalement convenir, un simple et 
direct et un qui passe par le cousin de I'oncle du fils du frere, autant prendre le simple 
et direct. 
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D'ou I 'idee de restreindre a priori la region de I'arbre dans laquelle la recherche sera 
effectuee, ce qui bien sflr limitera le motif a des relations de parente compatibles avec 
cette region. 

Or, clairement, la region la plus favorable pour lancer une recherche a parti r d' un noeud 
donne est celle qui est constitute des ancetres de ce noeud. En effet, la remontee vers un 
parent ne laisse jamais aucun choix, alors que la descente vers un enfant donne autant de 
choix possibles qu'il y a d'enfants : la remontee vers les ancetres s'apparente au simple 
parcours d'une liste lineaire, alors que la descente vers les enfants reste un processus 
eminemment arborescent et recursif. 

Si maintenant on veut que la recherche de concordance entre un motif et un noeud N 
donne ait une chance d'aboutir, alors qu'on limite a priori la recherche d'un noeud 
contexte convenable aux ancetres de N , il est imperatif que le motif ne fasse pas inter- 
vene d'autre axede localisation que child: :. 

D'ou la regie : 
Contrainte des ancetres 

Un motif ne peut mentionner aucun axe de localisation, sauf child: :. On verra (Syntaxe et contrainte pour un 
motif XSLT, page 98) que Ton peutquand meme relaxer un peu cette contrainte, car il y a des axes (comme 

attribute:: oil namespace: :) qui ne font pas de mal. 



Examinons cela sur un exemple (figure 3-11) : 
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Figure 3-11 

Recherche de concordance. 



Au cceur du langage XSLT 

Chapitre 3 



Cet exemple montre un arbre XML avec deux nceuds <d> et leurs ancetres communs <b>, 
<c>, <a>. On suppose que I 'un desdeux nceuds <d> (en grise sur la figure) est lenceud que 
Ton veut tester par rapport au motif suivant (exprime en syntaxe longue) : 

child:: a/child: :b/child: : c/chi 1 d : :d 

Puisque dans le processus de recherche de concordance de motif, on decide de se limiter 

aux nceuds ancetres du nceud test, seuls les noeuds notes (1), (2), (3), (4) etc. (jusqu'a 

la racine de I'arbre) vont etre successivement choisis comme nceud contexte. En (1), 
devaluation du motif va renvoyer un ensemble de nceuds (node-set) vide, car lenceud <c> 
n'a aucun enfant <a>. On refaitevidemmentlememe constat aux etapes(2) et (3). En (4), 
devaluation du motif renvoie un ensemble de nceuds constitue des deux elements <d> ; 
cet ensemble contient le nceud test: la concordance est done etablie, et la recherche 
s'arrete. 

M ais maintenant imaginonsqu'un motif puissementionner des axes de localisation quel- 
conques, et pas seulement child: :, et que I 'on puisse ecrire par exemple : 

chi 1 d: :a/fol lowing: : b/chi 1 d: : c/chi Id: :d 

Arrives a I'etape (2), nous ne pourrions plus nous permettre de remonter « betement» 
vers I'ancetre suivant, puisqu'a coup sfir, nous irions a I'echec ; il nous faudrait aller 
explorer certains des freres, oncles et neveux de <t>> (voir figure 2-10 a la section Repre- 
sentation graphique, page 50), et pour chacun d'eux remonter sa lignee d'ancetres. 

Ayant vu I'interet qu'il peut y avoir (en termed 'efficacite) a limiter a priori la recherche 
de concordance de motifs a la seule lignee d'ancetres du nceud test, il faut maintenant en 
examiner les consequences sur le pouvoir expressif des motifs. 

M ais qu'est-ce que le pouvoir expressif d'un motif ? Est-ce sa capacite a ratisser large, 
ou au contraire a discriminer finement? 

II n'y a aucun doute que e'est sa capacite a discriminer finement ; un exemple de motif 
ne discriminant pas grand-chose serait child: modeo : un tel motif Concorde avec 

n'i mporte quel nceud de type element node, comment node, processing instruction 

node, ou text node (voir Modele arborescent d'un document XML vu par XPath, 
page 30). 

Autant dire que si on equipe une regie d'un tel motif, la regie s'appliquera partout ou 
presque dans le document X M L ; il n'y a guere que la racine (qui est fille de rien 1 ), les 
attributs et les domaines nominaux qui neseront pas concerned par cette regie. 

On voit done que le motif le plus « ramasse-tout » que I'on puisse ecrire est compatible 
avec la contrainte des ancetres. 

Done, si on avait du souci a sefaire sur une diminution du pouvoir expressif d'un motif, 
a cause de I 'introduction de la contrainte des ancetres, ce serait pi utot du cote d'une dimi- 
nution de pouvoir discriminant qu'il faudrait regarder. 



1. et comme telle, ne repond jamais quand on la traite de « child : : » 



Motifs (patterns) 

Chapitre 3 



M ais en fait, il n'y a pas de probleme : meme s'il verifie la contrainte des ancetres, un 
motif peut rester tres di scri mi nant. 

Reprenons I'exemple deja vu pour illustrer le propos : 

<?xml version="1.0" encoding="UTF-8"?> 
<Sai son> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Prenons le motif Heure : il n'est pas tres discriminant, car trois elements differents 
concordent avec ce motif. M ais le motif concert/Date/Heure I'est beaucoup plus : un 
seul element du document XML concorde avec ce motif. 1 1 est vrai que c'est parce qu'il 
n'y a qu'un seul concert dans le fichier, et que le motif Theatre/Date/Heure pourtant 
construit de la meme facon, est un peu moins discriminant, avec deux elements concor- 
dats. 

M ais rien n'empeche, s'il le faut, de renforcer la discrimination en faisant intervenir un 
predicat. Un predicat, present dans I 'expression d'un motif, peut etre aussi complexe 
qu'on le veut, car sa complexity n'a aucune influence sur la localisation d'un nceud 
contexte adequat pour la recherche de concordance, localisation qui sera toujours limitee 
aux ancetres du nceud test. 

Le motif Theatre/Date/Heure evalue sur le noeud contexte <saison> donne en resultat 
un ensemble de deux nceuds : le nceud <Heure> 21H </Heure> et le nceud <Heure>2iH30 
</Heure>. Supposons que I'on veuille trouver un motif qui designe uniquement I'une de 
ces deux heures ; supposons de plus que I 'heure qui nous interesse soit celle du mer- 
credi ; on peut alors exprimer que c'est une <Heure> enfant d'une <Date> dont le texte 
(i.e. child: :text( )) est une chalne qui contient « M ercredi », cette <Date> etant el I e- 
meme enfant de <Theatre>. 

Ce qui donne le motif : 

Theat re/ Date[ con tains (child: :text( ) , "Mercredi " )] /Heure 

On voit done qu'il n'y a pas de souci a se faire sur les capacites discriminantes des 
motifs, meme s'ils respectent la contrainte des ancetres. 
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Syntaxe et contrainte pour un motif XSLT 

Le motif, ou pattern, fourni en tant que valeur de I'attri but match, s'exprime sous la 
forme d'une expression X Path detype Pattern LocationPath. 

<xsl : tempi ate match=" .. .Pattern LocationPath. .. "> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Un Pattern LocationPath estun ensemble decheminsde localisation separes pardes "|" 
(qui veulent dire « ou ») ; lesdifferentesetapesdechacun decescheminsde localisation 
doivent etre construites uniquement sur les axes child: : ou attribute: :, a I 'exclusion 
detous les autres axes. 

En consequence, les abreviations "." et sont interdites dans un Pattern Loca- 
tionPath : "./True" n'est pas autorise, puisque e'est equivalent a "self: : node()/ 
child: :Truc", et que "self::" estinterdit; de meme, "../True" est interdit a cause de 

I 'equivalence avec "parent: : node () /child: :Truc". 

Bien que I'axe "descendant-or-seif : : " soit done a ce titre interdit de sejour dans 
I'expression d'un motif, la version abregeede "/descendant-or-seif : :nodeo/" sous la 
forme "//" est tout de memeautoriseeen tant que separateur d'etapes, a la place du "/". 
On remarquera que cette tolerance est compatible avec la contrainte des ancetres. 

Par contre, dans un predicat, aucun typed'axe de localisation n'est interdit. 

Notons pour finir que I'emploi de parentheses (autres que eel I es qui servent a certains 
determinants, comme texto, par exemple) est interdit dans un Pattern LocationPath, 
sauf bien sur dans les eventuels predicats. 

Exemples de motifs 

Nous allons maintenant voir quelques exemples de motifs (Pattern LocationPath), avec 
ou sans predicats. 

Remarque 

Donnerdes exemples de motifs n'auraitpas beaucoup de sens si on ne pouvaitrien faire d'autre d'un motif que 
de I'evaluer : il faudrait alors donnerachaque fois un document XML, un nceud contexte, etun nceud test. 
Mais au lieu dechercheraevaluerun motif, on peutse contenterde chercheraevaluerson pouvoir discriminant 
etde voirce qu'il discrimine, dans I'absolu, en dehors de toute donnee XML. 

child: :chapit re/child: :sect ion/child: :paragraphe 

Forme courte : 

chapit re/section/pa rag raphe 

concorde avec tous les noeuds de I'arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <chapitre> enfant du nceud contexte (quel qu'il soit). 
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child: :chapi tre/descendant-or-sel f : :node( ) /child: :paragraphe 



Forme courte : 
chapitre//paragraphe 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> enfants de 
nceuds qui sont des descendants (au sens large) de <chapitre> enfant du nceud contexte 
(quel qu'il soit). 

chapitre/section | annexe 

Concorde avec tous les noeuds d'un arbre XML qui sont soit des <annexe>, soit des 

<section> elleS-ITIemeS enfantS de <chapitre>. 
child: :paragraphe/attribute: :alignement 

Forme courte : 

pa ragraphe/@al ignement 

Concorde avec tous les noeuds alignment d'un arbre XML qui sont des attributs de 
<paragraphe> enfant du noeud contexte (quel qu'il soit). 

paragraphe/processing-instructiont ) 

Concorde avec tous les noeuds de type processing-instruction d'un arbre XML qui 

SOnt deS enfantS de <paragraphe>. 

chapitre/section/paragraphe[@al ignement = "centre"] 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <cnapitre>, a condition que les <paragraphe> pos- 

Sedent un attri but al ignement egal a "centre". 

chi 1 d: : chapi tre[fol 1 owing-sibl ing: : annexe] /descendant-or- sel f: :node( )/ 
child: :paragraphe 

Forme courte : 

chapi tre[fol 1 owing-sibl ing: : annexe] //pa rag raphe 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> descendants 
de <chapitre>, a condition que ces chapitres soient suivis par une <annexe> au meme 
niveau hierarchique. Cette traduction estun peu libre, maisellerefletebien lasemantique 
decequ'on veutexprimer : on imagine un livre constitue de parties, elles-memes consti- 
tutes de chapitres qui se suivent, sur le meme plan hierarchique, le dernier chapitre d'une 
partie pouvant etre en fait une annexe (facultative). Pour un chapitre donne, les chapitres 
qui suivent (dans la meme partie) sont situes sur I'axe de localisation foiiowing- 
sibling, de SOrte que I'expression chi1d::chapitre[fo1low1ng-sibling: rannexe] 
denote un ensemble de chapitres qui tous font partie d'une serie termi nee par une annexe 
(au sein de la meme partie). Une regie possedant ce motif s'appliquera en definitive a 
tous les paragraphes d'une serie de chapitres d'une meme partie terminee par une 
annexe. Notons pour finir que rien, dans cette expression XPath, n'imposequ'uneeven- 
tuelle annexe soit le dernier element d'une serie de chapitres ; on pourraittres bien avoir 
une annexe en plein milieu d'une partie, avec des chapitres avant, et des chapitres apres. 
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Si c'etait le cas, seuls les chapitres situes avant pourraient concorder avec ce motif ; mais 
en pratique, il n'est pas courant devoir une annexe troner au milieu de chapitres. 

child: :chapitre[position( ) = lastO] | child: :annexe 

Forme courte : 
chapitre[last()] | annexe 

concorde avec tous les nceuds de I'arbre XML qui sont des <annexe> ou bien des 
<chapitre>, a condition que ces chapitres soient en derniere position sur I'axe de locali- 
sation child: :. En somme, si I 'on reprend les explications du precedent ex emple, on voit 
que ce motif va concorder avec le dernier chapitre de chaque parti e, que ce chapitre soit 
un vrai chapitre ou qu'il soit en fait une annexe. 

Pour la fonction iast( ), revoir la section Contexte devaluation d'un pr<?dicat, page 57. 

Les motifs sont sensibles aux restrictions lexicales imposees par la notion d'attri but en 
XM L. Parexemple, lechemin XPath chapitre/section[ positiono < 3 ] est correct. 

Pourtantil n'est pas possible d'en faireun motif a cause du caractere« < » qui estinterdit 
dans la chaine de caracteresformant la valeur d'un attri but. 1 1 n'y a malheureusement pas 
d'autre solution que d'ecrire quelque chose du genre : 

<xsl :templ ate select="chapitre/section[ positionO < 3 ]"> 

ce qui n'arrange guere la lisibilite de la chose. 



Priorities entre regies 

Algorithme de calcul des priorites par defaut 

II peutarriver, au coursdu processus de traitement (voir P rincipe de fonctionnement d 'un 
processeur XSLT, page 83), que plusieurs regies soient eligibles : pour chacune d'entre 
elles, le motif concorde avec le nceud en cours de traitement. Un algorithme de calcul de 
priorite par defaut est alors mis en ceuvre pour en selectionner une ; cet algorithme est 
assez complexedans le detail, mais grosso-modo, on peut direqu'entre deux regies dont 
I 'une est plus specifique que I 'autre, c'est a la plus specifique que la priorite la pi us forte 
est aff ectee. 

Un cas tres courant ou cette notion de « plus specifique » s'applique defacon evidente, 
est celui d'une concurrence entre deux regies dont I'une utilise un joker (■*-) : 

<xsl : tempi ate match="Heiire"> 

</xsl :templ ate> 

<xsl :templ ate match="*"> 

</xsl :templ ate>> 

En reprenant le fichier XML dejavu en Motifs (patterns), page 91 : 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 



Resume | 
Chapitre 3 | 

<Concert> <Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

</Saison> 

on voitquesur n'importequel nceud <Heure> decefichier, les deux regies ci-dessussont 
egalementappli cables. Neanmoins, •*■ etant moins specifiqueque "Heure", c'est la pre- 
miere regie qui va I'emporter. 

Forgage de la priorite 

L'algorithme de calcul des priorites par defaut etant assez fasti dieux a suivre, il est prefe- 
rable de ne pas s'y confronter, d'autant que c'est toujours possible. En effet, il existe un 
attri but priori ty qui permet d'affecter une priorite a une regie, ce qui permet de forcer la 
decision dans les cas ou I'on sent que I'on ne maitrise plus tres bien cequi va se passer : 

<xsl : tempi ate match='Theatre//Heure' priority="2"> 
</xsl : tempi ate> 

<xsl :template match='Heure' priority="l"> 
</xsl : tempi ate> 

L'heure d'un concert sera prise en compte par la deuxieme regie, car pour un concert, le 
motif dela premiere neconcorde pas : pasd'ambiguite. Par contre I 'heure d'une piece de 
theatre peut etre prise en compte par les deux regies ; la priorite de 2 sur la premiere lui 
permet de I'emporter. 

A chaquefoisqu'un programmeXSLT contient des regies simultanement eligibles, il est 
detres loin preferable d'imposer les priorites que I'on souhaite, plutotquedese hasarder 
a finasser sur les priorites par defaut ou de tester ce que eel a donne avec tel ou tel proces- 
ses particulier, et d'en tirer des conclusions qui neseront peut-etre pas... concluantes. 

Resume 

N ous avons vu la forme generale d'une regie X SLT (voi r Forme d 'une regie XSLT, page 79) : 

<xsl :template match="... motif (pattern) ..."> 
<!-- modele de transformation --> 



melange de texte et d'instructions XSLT du genre 
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<xsl :xxx ...> ... </xsl :xxx> 

<!-- fin du modele de transformation --> 
</xsl :template> 

Puis nous avons vu le modele detraitement, qui expliquece que fait leprocesseur XSLT, 
et comment les regies X SLT interviennent dans ce processus. 

Enfin nous avons vu la notion de motif, etde concordance de motif. 

1 1 reste done encore a voir les di fferentes i nstructi ons X SLT, i ntervenant dans I e corps des 
model es de transformation. 

M ais avant eel a, nous all ons maintenant detainer les deux instructions fondamentales de 
XSLT, a savoir xsi:vaiue-of et xsi : appiy-tempi ates. Ces deux instructions sont 
importantes a comprendre en profondeur, parce qu'elles se competent tellement qu'on 
peut dire qu'a el les deux, el I es forment le noyau dur des possi bi I ites de transformations 
real i sables en XSLT. 



Note 

Certains auteurs parlent d'extraction individuelle (pull processing) pour <xsl:value-of> etde distribution selective 
(push processing) pour <xsl:apply-templates>, par reference a certains langages specialises dans le traitement 
et la manipulation de chaines de caracteres, comme awk sous Unix. Meme si I'on peut trouver que cette termi- 
nologie ne facilite pas vraimentla comprehension de la chose, il est tout de meme remarquable de voir que ce 
sont ces deux mots si complementaires (push et pull) qui ontprecisementete choisis pour caracteriser la nature 
de ces deux instructions. 

Instruction xsl:value-of 

Une regleXSLT uti I isant I 'instruction xsi :vaiue-of a d'ordinaire I'allure suivante : 

<xsl :terapl ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 

mel ange de texte et 
d'instructions XSLT de la forme : 

<xsl :value-of select="... chemin de localisation ..." /> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Comme son nom I'indique, instruction <xsi :vaiue-of seiect=". ..- /> estremplacee 
lors de I'instanciation du modele par la valeur textuelle de ce qui est designe par I 'attri but 
select. II s'agitdonc de la valeur textuelle (i.e. sous forme dechainede caracteres) d'un 
node- set. 

Un node-set comportant en general plusieurs nceuds source, sa valeur textuelle est defi- 
nie comme etant eel le du nceud source qui arrive en premier dans I'ordre de lecture du 
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document, instruction est done final ement remplacee par la valeur textuelle d'un noeud, 
notion qui a ete definie a la section Modele arborescent d'un document XML vu par 
XPath, page 30 et suivantes. Quant au node-set en question, il resulte de I 'evaluation du 
chemin de localisation fourni comme valeur de I'attribut select. Ce chemin de localisa- 
tion est calcule en prenant le noeud courant comme noeud contexte. 



Exemple 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<0rganisation> Anacreon </0rganisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 
<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

Date Concert : <xsl :val ue-of select="Saison/Concert/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl :templ ate> 

</xsl :stylesheet> 

Cet exemple est d'un style assez contestable, car la regie XSLT indiquee presuppose 
qu'il y ait 1 element <concert> et 2 elements <Theatre> dans le fichier XML traite. 
Neanmoins, il est interessant parce qu'il ne requiert que des connaissances XSLT deja 
vues, pour etre analyse et compris. 

Appliqueeau fichier saison.xml , cette feui I le de style produit le resultat suivant : 
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Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

La declaration <xsi:output method='text , encoding='UTF-8'/> permet de specifier 
que I'on veut generer un resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit. Si I'on supprimait cette 
declaration, voici le resultat que I'on obtiendrait : 

<?xml version="1.0" encoding="UTF-8"?> 



Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XML genere automatique- 
ment, en contradiction avec la suite du fichier qui n'a pas du tout I'air d'un fichier XM L. 

Deroulement du processus de traitement sur cet exemple 

Cette section estasuivre en parallele avec la section M odele de traitement, page 87. 

Constitution d'une liste ne contenantque la racine 

C'est initialisation du traitement; une liste est constitute, ne contenant que la racine, 
puis le traitement general de traitement des listes est lance (voir figure 3-12). 



Figure 3-12 

Constitution d'une 
liste ne contenant 
que la racine. 




Traitement de cette liste 

Le traitement de cette I istese decompose en deux etapes : traitement de chaque nceud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-13). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 

Traitement du nceud 

Dans notre exemple, il n'y a qu'uneseule regie, etson motif concordeavec le nceud cou- 
rant (e'est-a-dire la racine). La regie va done s'appliquer, ce qui veut dire que le modele 
de transformation associe va etre instancie (voir figure 3-14). 



Traitement 
(D+(2) 



Listea traiter 
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Document resultat 



DateConcert: Samedi 9 Octobre 1999 20H30 
Date Theatre: Mardi 19 Novembre 1999 21H 
Date Theatre: Mercredi 20 Novembre 1999 21H30 



root 



Traitement 
du nceud root 
(1) 



DateConcert: Samedi 9 0ctobrel999 20H30 
Date Theatre: Mardi 19 Novembre 1999 21H 
D ate Theatre : M ercredi 20 N ovembre 1999 21H 30 



Figure 3-13 

Traitement de cette liste. 



(2) 

Concatenation 
(non effective pour 1 seul element) 



Programme XSLT 



m> ^ concordance . „ 

root (J ^ — ^<xsl : tempi ate match=/> 




Theatre 



leu 



Date Concert : <xsl:value-of select-' Saison/Concert/Date"/> 
DateTheatre : <xsl:value-of select="Saison/Theatre[l]/Date"/> 
DateTheatre : <xsl:value-of select="Saison/Theatre[2]/Date"/> 



</xsl:template> 



Heure 



Instanciation 



DateConcert: Samedi 90ctobrel999 20H30 
DateTheatre : M ardi 19 Novembre 1999 21H 
DateTheatre: Mercredi 20 Novembre 1999 21H30 



Figure 3-14 

Traitement du na»ud. 
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Instanciation du modele 

Le model ede transformation est ici constitue d'un melange de textes ordinal res (comme 
par exemple « Date Concert : ») qui seront done recopies tels quels dans le fragment de 
document resultat, etd'instructions <xsi :vaiue-of>, qui seront done remplaceespar leur 
valeur dans le fragment de document resultat (voir figure 3-15). 



M odele 



Date Concert : 



<xsl:value-of select="Saison/Concert/Date"/> 



Date Theatre : 



<xsl:value-of select="Saison/Thcatre[l]/Date"/> 



D ate T hcatre 



<xsl:value-of select="Saison/Thcatre[2]/Date"/> 



Figure 3-15 

I nstanciation du modele. 



recopie 
remplace par sa valeur 

recopie 
remplace par sa valeur 

recopie 



remplace par sa valeur 



Fragment de 
document resultat 



Date Concert : 



Samedi 9 Octobre 1999 20H30 



D ate T hcatre : 



Mardi 19 Novembre 1999 21H 



D ate T hcatre : 



Mercredi 20 Novembre 1999 21H30 



Valeur des differents node-sets 

Node-set "Saison/Concert/Date" 

Pour devaluation de cette expression XPath, le nceud contexte est root . La valeur d'un 
node- set est eel le de son premier element dans I 'ordre de lecture du document (voi r I nstruc- 
tion xsl : val ue-of, page 102) ; ici, I e node-set, calcule a parti r du nceud contexte root , pos- 

Sede Un Seul element : <Date>Samedi 9 octobre 1999 <Heure> 20H30 </HeureX/Date>. 

La valeur de cet element est egale au texte « Samedi 9 octobre 1999 » concatene a la 
valeur de I'element <Heure> 20H30 </Heure> (voir Na?ud de type element, page 31) qui 
elle-meme est egale au texte « 20H30 ». Ce qui donne finalement « Samedi 9 octobre 
1999 20H 30 ». 

Node-set "Saison/Theatre[l]/Date 

Pour 1'evaluation de cette expression XPath, le nceud contexte est root . La valeur d'un 
node- set est eel le de son premier element dans I 'ordre de lecture du document (voi r I nstruc- 
tion xsl:value-of, page 102) ; ici, le node-set, calcule a partir du nceud contexte root , pos- 

Sede Un Seul element : <Date>Mardi 19 novembre 1999 <Heure> 21H </HeureX/Date>. 

La valeur de cet element est egale au texte « M ardi 19 novembre 1999 » concatene a la 
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valeurdel'element<Heure> 21H </Heure> </Date> (voir Na?ud de type element, page 31) 
qui elle-memeestegaleau texte« 21H ». Cequi donne final ement« M ardi 19 novembre 
1999 21H ». 

Node-set "Saison/Theatre[2]/Date 

En suivant exactement le meme raisonnement, on obtient « M ercredi 20 novembre 1999 
21H30 ». 

Instruction xshapply-templates 

Une regie XSLT utilisant ^instruction xsi :appiy-tempiates a generalement la forme 
suivante : 

<xsl : tempi ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
. . . texte . . . 
<xsl :apply-templates /> 
. . . texte . . . 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

L'instruction <xsi :appiy-tempiates/> est remplacee par le fragment de document qui 
resulte du traitement de la liste des enfants du nceud courant. Le detail important, ici, est 
que cette liste, que nous avions deja evoquee (voir I nstanciation d 'un modele de transfor- 
mation relativement a un nceud courant et une liste courante, page 90) est constitute des 
elements enfants du nceud courant, pris dans I 'ordre de lecture du document source. 

Exemple 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :template match='Saison'> 

Manifestations an programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :templ ate> 
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<xsl : tempi ate match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl :templ ate match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 

</xsl :stylesheet> 

Appliquee au meme fichier Sanson. xmi que celui vu precedemment (voir Exemple, 
page 103), cette feuille de style produit le resultat suivant : 

Manifestations au programme 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 



Theatre : 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 

Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Reservations 10 jours avant la date. 

Deroulement du processus de traitement sur cet exemple 

Cette section estasuivre en parallele avec la section M odele de traitement, page 87. 

Constitution d'une liste ne contenantque la racine 

C'est ^initialisation du traitement; une liste est constitute, ne contenant que la racine, 
puis I e traitement general de traitement des listes est lance (voir figure 3-16). 

Traitement de cette liste 

Letraitementdecettelistese decompose en deux etapes : traitement de chaque nceud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-17). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 
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Figure 3-16 

Constitution d'une 
liste ne contenant 
que la racine. 




Figure 3-17 

Traitement 
de cette liste. 



Traitement 
(D+(2) 



Listen traiter 



root 



Document resultat 



Concert : 
Pygmalion 

Samedi9 0ctobrel999 20H30 
ChapelledesUrsules 



Masques etLyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 



Traitement 
du nceud root 
(1) 



M anifestations au programme 



Concert : 
Pygmalion 

5amedi9 0ctobrel999 20H30 
Chapelle des Ursules 



Theatre : 

M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 



Concatenation 
non effective pour 1 seul element) 
(2) 



Theatre : 
Aristophane 

M ercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



Reservations 10 jours avant la date. 
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Traitementdu nceud 

Dans notreexemple, il n'y a qu'uneseule regie, etson motif concorde avec le nceud cou- 
rant (c'est-a-dire la racine). La regie va done s'appliquer, cequi veut dire que le modele 
de transformation associe va etre instancie (voir figure 3-18). 



Programme XSLT 

I 'ordre des regies etant indifferent, 
la premiere a e'te' place'e en dernier 
par commodite' 

<xsl:template match='Saison'> 

M anifestations au programme 
<xsl :apply-templates/> 
Reservations 10 jours avant la date. 
</xsl:template> 



<xsl:template match='Concert'> 

Concert : <xsl:value-of select- 1 . "/> 
</xsl:template> 



root Q< 



concordance 




Heure 



<xsl:template match='Theatre'> 

Theatre : <xsl:value-of select= 
</xsl:template> 

^ <xsl:template match=7'> 

<xsl:apply-templates/> 
</xsl:template> 



7> 



Instanciation 



M anifestations au programme 

Concert: 
Pygmalion 

Samedi9 0ctobrel999 20H30 
ChapelledesUrsules 



Theatre : 

Masques et Lyres 
Mardil9Novembrel999 21H 
Salle desCordeliers 



Reservations 10 jours avant la date. 



Figure 3-18 

Traitement du na?ud. 



Instanciation du modele de transformation 

Le modele a instancier comportant une instruction <xsi :appiy-tempiates>, celle-ci est 
remplacee par sa valeur, resultant du traitement d'une nouvelle liste de nceuds. Cette nou- 
velle liste est constitute en rassemblant tous les nceuds enfants du noeud courant. Ici, 
comme le noeud courant est root , il n'y a qu'un seul enfant, qui est le noeud <saison> 
(voir figure 3-19). 
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M odele 



<xsl:apply-templates/> 



G enerat 
nouve 
( 


on d'une 
le liste 

U 







Listen traiter 



Saison 



Traitement 
du noeud 
Saison 
(2) 



M anifestationsau programme 



Concert: 
Pygmalion 

Samedi 9 Octobrel999 2OH30 
Ctiapelledes Ursules 



Theatre : 

M asqueset Lyres 
Mardi 19 Novembre 1999 21H 
Sal le des Cordeliers 



Theatre : 
Aritophane 



ovations 10 jours avant la d; 



Fragment de 
document resultat 



remplace par sa valeur 
(D+(2)+(3) 



Traitement 
(2) +(3) 



M .::-:'L..I'=e; =e Lyres 

Mardi 19 Novembrel999 21H 

Salle de5 Cordeliers 



Aristophane 

Mercredi 20 Noi/embre 1999 21H30 
Si ~ 'Jr^ Cordeliers 



Concatenation 
(non effective pour 1 seul element) 
(3) 



Figure 3-19 

Instanciation du modele de transformation. 



Au cceur du langage XSLT 

Chapitre 3 



Traitementdu nceud <Saison> 

Le nceud <Saison> est le nceud COUrant; la regie <xsl :template match='Saison'> 

concorde avec ce nceud, el I e est done appliquee (voir figure 3-20). Son application se tra- 
duit par I'instanciation du modele de transformation associe. 



root 



T heatre 




concordance 



leu 



Heure 



Programme XSLT 

I 'ordre des regies etant indifferent, 
la regie se'lectionne'e a e'te' place'e en 
dernier par commodite' 

<xsl:template match='/'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match-Concert'> 

Concert : <xsl:value-of select- 1 . "/> 
</xsl:template> 

<xsl:template match='Theatre'> 

Theatre : <xsl:value-of select-'. "/> 
</xsl:template> 

<xsl:template match='Saison'> 



M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 



</xsl:template> 



Instanciation 



M anifestations aj programm' 



Concert : 
Pygmalion 

Samedi9 0ctobrel999 20H 3D 
ChapelledesUrsules 

Theatre: 

Masques etLyres 

Mardi 19 Movembre 1999 21H 

Salle des Cordeliers 



Theatre: 

M ercredt 20 N Dvembre 1999 21H 30 
Salle des Cordeliers 



Reservations 10 jours avant la date. 



Figure 3-20 

Traitementdu n«?ud <Saison>. 



Instanciation du modele de transformation 

Le modele a instancier comporte d'une part du texte ordinaire qui est done recopie dans 
le fragment de document resultat, et d'autre part une instruction <xsi :appiy-tempi atesx 
Elle est remplacee par sa valeur, qui resulte du traitement d'une nouvelle liste de nceuds 
comportant I'ensemble des nceuds enfants du noeud courant, e'est-a-dire I'element 
<Saison> (voir figure 3-21). 



M odele 



Instruction xshapply-templates 

Chapitre 3 

Fragment de 
document resultat 



M anifestations au programme 



recopie 



<xsl:apply-templates/> 



rem place par sa valeur 



)+(2)+(3)+(4)+(5) 



Reservations 10 jours avant la date. 



Generator! d'une 
nouvelle liste 
(1) 



Liste a traiter 



Concert 



Theatre 



Traitement 
du noeud 
Concert 
(2) 



Traitement 
du nceud 
Theatre 
(3) 



Traitement 
(2)+(3)+(4)+(5) 



recopie 



Theatre 



Traitement 
du noeud 
Theatre 
(4) 



Concert : 
Pygmalion 

Samedi SOctobre 1999 2OH30 
Chapelledes Ursules 



T heatre : 

M asques et Lyres 

Mardi 19 Novembrel999 21H 

Salle des Cordeliers 



Theatre : 
Aristophane 

Mercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



- M anifestations au programme 



Pygmalion 

Samedi 9 Octobre 1999 20H30 
Chapelle des Ursules 



Salle des Cordelia 



A ristophane 

M ercredi 20 Novembre 1999 21H3C 
5=i le Lies Cordeliers 



. Reservations 10 jours avant la date. 



Concatenation 
(5) 



Figure 3-21 

Instanciation du modele de transformation. 
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II y a done desormais trois traitements separes a effectuer (qui pourraient, dans I 'ideal, 
etre realises simultanement sur trois processeurs materiels differents), un pour le nceud 
<concert>, un pour le premier nceud <Theatre>, et un pour le deuxieme noeud <Theatre>. 

Premiere branche du traitement (nceud <Concert>) 

Traitementdu noeud <Concert> 

Le noeud <Concert> est le noeud COUrant; la regie <xsl ttemplate match='Concert'> 

concorde avec ce noeud, el I e est done appliquee (voir figure 3-22). Son application setra- 
duit par I'instanciation du modele de transformation associe. 



Programme XSLT 

I'ordre des regies etant indifferent, 
la regie se'lectionne'e a M place'e en 
dernier par commodite' 

<xsl:template match=7'> 

<xsl:apply-templates/> 
<xsl:template> 



<xsl:template match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 



root % 




concordance 



Theatre 



<xsl template match='Theatre'> 

Theatre : <xsl:value-of select-'. "/> 
</xsl:template> 

<xsl:template match-Concert'> 

Concert : <xsl:value-of select-'. "/> 



Heure 




Lieu 



</xsl:template> 



Instanciation 



Concert : 
Pygmalion 

Samedi 9 0ctobrel999 20H30 
Chapel I e des Ursules 



Figure 3-22 

Traitementdu na?ud <Concert>. 
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Instanciation du modele de transformation 

Le model e de transformation contient du texte neutre (recopie dans I e fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplaceeparsa valeur, sur le principe deja vu dans la section Va leu r des differents node- 
sets, page 106. La figure 3-23 montred'une part I 'instanciation du modele, etd'autre part 
les etapes du calcul de la valeur du node-set reduit au seul element <concert>. 



M odele 



Concert : 



<xsl:value-of select=".7> 



recopie 



Fragment de 
document resultat 



Concert: 



remplace par sa valeur 



Pygmalion 

Samedi 9 0ctobrel999 20H30 
Chapel le des Ursules 



element 

Organisation 



_ text _ 

Pygmalion 



text 



Samedi 9 
Octobrel999 



element 

Concert 



element 

Date 



element 

Heure 



. text 

20H30 



element 

Lieu 

. text _ 



Chapel I e des 
Ursules 



valeur( <Concert> ) = 
concatenation! 

valeur( <Organisation> ) + 
valeur( <Date> ) + 
valeur( <Lieu> ) 

) 

valeur( <Organisation>) = ""Pygmalion" 

valeur( <Date>) = 

"Samedi 9 Octobrel999" + 
valeur( <Heure> ) 

valeur( <Lieu>) = "Chapel le des U rsules" 

valeur( <Heure>) = "20H 30" 



Figure 3-23 

Instanciation du modele de transformation. 
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Deuxieme branche du traitement (noeud <Theatre>) 

Traitement du premier noeud <Theatre> 

Le premier noeud <Theatre> est le noeud courant ; la regie <xsi :tempiate matcri=' Thea- 
tre^ concorde avec ce noeud, el I e est done appliquee (voir figure 3-24). Son application 
se traduit par I'instanciation du modelede transformation associe. 



Programme XSLT 

I'ordre des regies e'tant indifferent, 
la regie se'lectionne'e a M place'e en 
dernier par commodite' 

<xsl template match=7'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl tempi ate match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 



Instanciation 

t 

Theatre : 

M asques et Lyres 

Mardi 19 Novembrel999 21H 

Salle des Cordeliers 



Figure 3-24 

Traitement du premier nteud <The<2tre>. 



root 




concordance 



Theatre 



leu 



<xsl tempi ate match='Concert'> 

Concert : <xsl:value-of select-'."/: 
</xsl:template> 

<xsl template match=Theatre'> 

Theatre : <xsl:value-of select-'."/' 
<xsl tempi ate> 



Heure 



Instanciation du modele de transformation 

Le modelede transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des differents node- 
sets, page 106. La figure 3-25 montred'une part I 'instanciation du modele, etd'autre part 
lesetapesdu calcul de la valeur du node-set reduitau seul element <Theatre> (le premier 
des deux). 
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M odele document resultat 







recopie 










Theatre : 






Theatre : 




rem place par sa valeur 








M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 






<xsl;value-of select="."/> 








- 







element 

I Organisation J 



text 

M asques et 
Lyres 



text 



M ardi 19 
Novembre 1999 



element 

Theatre 



element 

Date 



element 

Heure 



text 

21H 



element 

Lieu 

_ text _ 

Salle des 
Cordeliers 



valeur( <Theatre> ) = 
concatenation! 

valeur( <Organisation> ) + 
valeuri <Date> ) + 
valeurj <Lieu> j 



valeur( <Organisation> ) = "M asques et Lyres" 

valeur( <Date>) = 

"Mardi 19 Novembre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) = "Salle des Cordeliers" 

valeur( <Heure>) ="21H" 



Figure 3-25 

Instanciation du modele de transformation. 



Troisieme branche du traitement (nceud <Theatre>) 

Traitement du deuxieme nceud <Theatre> 

Le deuxieme nceud <Theatre> est le nceud courant; la meme regie <xsi :tempiate 
match=' Theatre' > concorde avec ce nceud, el I e est done a nouveau appliquee (voir figure 
3-26). Son application se traduitpar I'instanciation du model ede transformation associe. 
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root 




Programme XSLT 

I 'ordre des regies e'tant indifferent, 
la regie selectionne'e a ete' place'e en 
dernier par commodite' 

<xsl:template match='/'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 

<xsl:template match='Concert'> 

Concert : <xsl:value-of select- 1 . "/> 
</xsl :templ ate> 



tre . concordance , 

^ — ^ <xsl:template match-Theatre 



ieu 



Theatre : <xsl:value-of select-'. "/> 



Heure 



<xsl:template> 



Instanciation 



Figure 3-26 

Traitement du deuxieme na?ud <Theatre>. 



T heatre : 
Aristophane 

Mercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



Instanciation du modele de transformation 

Le model ede transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des differents node- 
sets, page 106. La figure 3-27 montred'une part I 'instanciation du modele, etd'autre part 
les etapes du calcul de la valeur du node-set reduit au seul element <Theatre> (le 
deuxieme). 

Synthese de ces trois traitements independants 

Les fragments de documents obtenus lors des instanciations de modeles (figures 3-27, 
3-25, 3-23) sont concatenes (voir etape (5) de la figure 3-21), ce qui donne la forme 
definitive du document resultat, que I 'on retrouve ensuite inchange lorsqu'on remonte 
depuis la figure 3-21 jusqu'a la figure 3-17 . 
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M odele 



Theatre : 



<xsl:value-of select=".7> 



recopie 



rem place par sa valeur 



Fragment de 
document resultat 



■ Theatre : 



Aristophane 

M ercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



element 

I Organisation J 



— text 

Aristophane 



text 



M ercredi 20 
Novembre 1999 



element 

Theatre 



element 

Date 



element 

Heure 



. text . 

21H30 



element 

Lieu 

_ text _ 

Salle des 
Cordeliers 



valeur( <Theatre> ) = 
concatenation! 

valeur( <Organisation> ) + 
valeuri <Date> ) + 
valeurj <Lieu> j 



valeur( <Organisation> ) = "Aristophane" 

valeur( <Date>) = 

"M ercredi 20 Novembre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) = "Salle des Cordeliers" 

valeur( <Heure>) = "21H 30" 



Figure 3-27 

Instanciation du modele de transformation. 



Regies par defaut 

II peutarriver quelorsdu traitementd'un nceud, aucune regie fournie dans le programme 
XSLT nesoit applicable, caraucun motif neconcordeavec le nceud courant. Danscecas, 
une regie par defaut est appliquee, qui depend de la nature du nceud a traiter. 

Et comme par hasard, les regies par defaut, que nous allons maintenant voir, n'utilisent 

que les deUX instructions xsl :value-of etxsl :apply-templates. 
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Regies par defaut pour la racine d'un arbre XML ou un element 

La regie par defaut instancie un fragment de document en reportant le traitement sur les 
enfants du noeud courant. 

Elles'exprimedonc ainsi : 

<xsl :templ ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 



Remarque 

line regie par defaut n'est jamais en conflit avec une regie explicite. II ne faut pas imaginer qu'une regie par 
defaut comme celle montree ci-dessus se comporte comme si elle etaitautomatiquementincorporee a la feuille 
de style par le processeur XSLT. Une regie par defaut reste interne au processeur; elle n'est activee que si 
aucune regie, dans la feuille de style, n'est applicable. Si dans votre feuille de style, vous avez une regie 
<xsi :tempiate match='*'> ... </xsi : tempi ate>, elle n'entrera jamais en conflitavec la regie par defaut, 
car la regie par defaut sera ignoree. 

Ce qui estditici estbien sur valable pourles autres regies par defaut decrites ci-dessous. 



Regies par defaut pour un noeud de type text ou attribute 

La regie par defaut instancie un fragment de document en prelevant la valeur du nceud 
courant. 

Elles'exprimedonc ainsi : 

<xsl :template match='text( ) [attribute: :*'> 

<xsl :val ue-of select = " . " /> 
</xsl :templ ate> 

Regies par defaut pour un nceud de type comment 
ou processing-instruction 

La regie par defaut instancie un fragment de document vide. 

Elles'exprimedonc ainsi : 

<xsl :template match='comirient( ) | processing-instruction( ) '> 
</xsl :templ ate> 

Exemples 

Nous conservons toujours le meme exemple de fichier XML a traiter; aucune regie 
explicite n'est cette fois fournie dans le programme X SLT : 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 
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<xsl:output method='text' encoding='UTF-8'/> 
</xsl :stylesheet> 

Le resultat obtenu est alors le suivant : 

Anacreon 

Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 



Masques et Lyres 
Mardi 19 novembre 1999 21H 

Salle des Cordeliers 



Masques et Lyres 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 

Ce resultat s'interprete ainsi : la racine de I'arbreX M L du document est traitee ; aucune 
regie ne s'applique (et pour cause), la regie par defaut 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl : tempi ate> 

est done appliquee, cequi entraineletraitementdu noeud racinedu document( <saison>). 
A ucune regie ne s'applique a ce noeud, la regie par defaut 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl : tempi ate> 

s'applique done a nouveau, ce qui entraine le traitement des nceuds <concert>, <Theatre>, 
<Theatre>. A ucune regie ne s'applique au noeud <concert>, la regie par defaut 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl : tempi ate> 

s'applique done a nouveau, ce qui entraine le traitement des nceuds <organisation>, 

<Date>, <Lieu>. 

Aucune regie ne s'applique au noeud <organisation>, la regie par defaut 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 
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s'applique done a nouveau, ce qui entralne le traitement du nceud text enfant de 

<0rgani sati on>. 

A ucune regie ne s'applique a ce noeud texte, la regie par defaut 

<xsl :template match='text( ) |attribute: :*'> 

<xsl :val ue-of select = "." /> 
</xsl :templ ate> 

s'applique done, cequi entraine I'instanciation du fragment de document Anacreon. 

II en va de meme pour les autres elements du document XM L : tous les elements sont 
traites par la regie 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 

ettous les nceuds text sont traites par la regie 

<xsl :template match='text( ) |attribute: :*'> 

<xsl :value-of select = "." /> 
</xsl :templ ate> 

ce qui finit par produire un document identique au document XML original, prive de 
toutesses balises. 

Le premier exemple que nous avons vu (voir Exemple, page 103) 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 
<xsl:output method='text' encoding='UTF-8'/> 

<xsl : tempi ate match='/'> 

Date Concert : <xsl : val ue-of select="Saison/Concert/Date"/> 

Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 

Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl :templ ate> 

</xsl :stylesheet> 

pourrait etre reecrit dans un style beaucoup plus correct, en utilisant les regies par 
defaut : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 
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<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl : tempi ate match=' Concert '> 

Date Concert : <xsl :val ue-of sel ect="Date"/> 
</xsl :templ ate> 

<xsl : tempi ate match='Theatre'> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 
</xsl :templ ate> 

</xsl :stylesheet> 

et on obtiendrait a nouveau : 

Date Concert : Samedi 9 octobre 1999 20H30 



Comportement inattendu d'un programme XSLT 

La presence de ces regies impli cites induisent parfois des comportements apparemment 
bizarres de la part du processeurXSLT, lorsquele source XSLT comporte uneerreur. Par 
exemple, introduisons une fautedefrappe dans la balise <Theatre> , en oubliant I 'accent 
circonflexesur le« a », commececi : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl :template match='Concert'> 

Date Concert : <xsl :val ue-of sel ect="Date"/> 
</xsl :templ ate> 

<xsl :template match='Theatre'> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Le resultat n'a alors plus rien avoir avec cequ'on souhaite : 

Date Concert : Samedi 9 octobre 1999 20H30 



Date Theatre 



Mardi 19 novembre 1999 21H 



Date Theatre 



Mercredi 20 novembre 1999 21H30 
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Masques et Lyres 
Mardi 19 novembre 1999 21H 

Salle des Cordeliers 



Masques et Lyres 
Mercredi 20 novembre 1999 21H30 

Salle des Cordeliers 

Le resultat obtenu etant plus volumineux que ce qu'on attendait, c'est done que des 
regies par defaut ont ete mises en ceuvre. 

Pour savoir exactement ce qui se passe, on peut incorporer au programme XSLT une 
regie « attrape-tout » : 

<xsl :templ ate match='*'> 

erreur : el ement non prevu : tag{ <xsl : val ue-of sel ect="l ocal -name( . )" /> } 
<xsl :apply-templates/> 
</xsl :templ ate> 

locai-nameo est une fonction qui renvoie le nom de I'element fourni en argument 
(ici « . », e'est-a-dire I'element courant). 

Le processeur X SLT applique cette regie de preference a la regie par defaut, 

<xsl :templ ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 

parce qu'une regie par defaut est par definition choisie quand aucune autre, fournie expli- 
citement, ne convient. Voici alors le resultat obtenu : 

erreur : element non prevu : tag( Saison } 
Date Concert : Samedi 9 octobre 1999 20H30 

erreur : element non prevu : tag{ Theatre } 

erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date } 
Mardi 19 novembre 1999 
erreur : element non prevu : tag{ Heure } 
21H 

erreur : element non prevu : tag( Lieu } 
Salle des Cordeliers 



erreur : element non prevu 



tag{ Theatre } 
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erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date ) 
Mercredi 20 novembre 1999 
erreur : element non prevu : tag{ Heure } 
21H30 

erreur : element non prevu : tag{ Lieu } 
Salle des Cordeliers 

Tous ces messages d'erreur sont coherents avec ce qu'on attend du programme XSLT, 
sauf celui concernant le tag Theatre puisque precisement notre programme est cense 
traitercet element en lui appliquant une regie explicite. L'element <Theatre> n'etant pas 
reconnu par I e motif de cette regie, la cause de I 'erreur est done maintenant facile a trouver. 



Conclusion 

Nous venons de voir la structure generale d'un programme XSLT, constitue de regies, 
avec leur motifs et leurs modeles de transformation. Une regie s'applique a un nceud si 
son motif concorde avec le nceud ; danscecas le model ede transformation est instancie, 
et nous avons vu les deux instructions les plus representatives qui entrent en jeu lors de 

Ces instanciations, xsl : val ue-of, et xsl :apply-templ ates, 

Nous allons maintenant voir plus en detail les instructions disponibles en XSLT, en les 
classant par grandes categories : les instructions de transformation (comme xsl : val ue- 
of et xsi :appiy-tempiates), les instructions de programmation, comme xsi:if, ou 

xsl :variable, et deS instructions de Creation, COmme xsl relement, OU xsl attribute. 

Comme toute classification, celle-ci est bien s(ir contestable, car il suffit de prendre un 
autre point de vue pour en obteni r une autre completement differente , ou pour se rendre 
compte que final ement, telle instruction classee dans les instructions de programmation 
auraitaussi bien pu etre classee dans les instructions de transformation. II nefautdonc 
pas y voir autre chose qu'un moyen commode pour amener les notions progressivement. 
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Les instructions 
de transformation 



Ce chapitre a pour but de faire decouvrir les instructions de transformation du langage 
XSLT, et d'en montrer le fonctionnement. L'exhaustivite propre a un manuel de refe- 
rence n'est pas recherchee ici, et tout ce qui aurait pu etre de nature a perturber la 
comprehension au point ou I'on en est dans la lecture de I'ouvragea ete elimine. 

Une annexe (voir Reference des instructions XSLT, page 623) reprendra la liste generale 
detoutes les instructions, avec cette fois I'integralite des attributs, de leurs proprietes, et 
deleurs valeurs possibles. 

A tout seigneur, tout honneur : nous commenceronsdonc par I 'instruction xsi :tempiate 
qui definit une transformation. Ensuite, nous verrons les deux instructions de base, 

xsl :value-of, et xsl : apply-templ ates. NOUS poursuivrons aveC xsl :for-each, la COU- 

sinedexsi :appiy-tempiates. Puisviendra leurassociee, xsi :sort. Enfin, noustermine- 
rons par I 'instruction xsi :copy-of, cousinedexsi :vaiue-of. 

Peut-etre n'est-il pas inutile d'expliquer pourquoi classer ces instructions dans la catego- 
rie des instructions de transformation. A pres tout, XSLT veut dire XSL Transformations, 
done toute instruction de ce langage pourrait valablement etre qualifiee d'instruction de 
transformation. 

Cependant, ce qui fait reellement I 'original ite et la puissance de XSLT, e'est son mo- 
dele de traitement (voir M od<?le de traitement, page 87). Et ce modele de traitement est 
concu pour fonctionner en faisant appel aux instructions xsi :vai ue-of et xsi :appiy- 
tempiates, sans lesquelles il n'est plus rien ; et reciproquement, ces instructions sont 
inutiles et inoperantes sans le modele de traitement. Les autres instructions listees ci- 
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dessus sont de la meme veine, et participent aussi a la mise en ceuvre du modele de trai - 
tement, tout en etant deja moins indispensables. 

Cequ'il fautdonc retenir, c'est que ce que nous appelons instruction de transformation, 
ce n'est pas une instruction effectuant en elle-meme une transformation quelconque, 
mais une instruction integree au coeurdu modele de transformation. 

Les autres instructions, que nous avons classees dans les categories d' instructions de pro- 
grammation ou de creation, pourraient tres bien etre supprimees du langage XSLT sans 
que cela casse le modele de traitement, qui conserverait toute la puissance de son prin- 
cipe. Ces instructions apportent des facilites complementaires, et augmentent chacune a 
leur maniere le champ d'appl ication du langage, mais sans rien apporter de fondamenta- 
I ement nouveau au model e de traitement, qui a I a I i mite, peut se contenter de I ' i nstructi on 

xsl :template, et des deUX instructions xsl :value-of et xsl :apply-templates pour 

fonctionner. 



Instruction xs litem plate 

Cette instruction a deja ete largement detaillee a I 'occasion de la description de instruc- 
tion xsi :vaiue-of (voir Instruction xsl:value-of, page 102) : nous nous contenterons de 
rappeler les elements essentiels et les variantes syntaxiques. 

Syntaxe 

xsl : tempi ate 

<xsl :templ ate match=" . . . motif ..." /> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

L'instruction xsi rtempiate doit apparattre uniquement comme instruction de premier 
niveau. 

Semantique 

Cette instruction, qui definit une regie, estau coeurdu fonctionnementdu langage XSLT ; 
on se reportera aux sections M od<?le de traitement, page 87, M otifs (patterns), page 91 et 
Priority entre regies, page 100, 

Instruction xsl:value-of 

Cette instruction a deja ete largement detaillee (voir Instruction xsl:value-of, page 102) : 
nous nous contenterons d'en indiquer les elements essentiels et les variantes syntaxiques. 
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Synfaxe 

xsl : val ue-of 

<xsl :val ue-of select="... chemin de localisation ..." /> 

L'instruction xsi :vai ue-of ne doit pas apparaltre en tant qu'instruction de premier 
niveau. 

Le chemin de localisation fourni comme valeur de I 'attri but sei ect n'est pas I i mite a cer- 
taines formes comme c'est le cas pour le motif (voir Syntaxe et contrainte pour un motif 
XSLT, page 98) ; toute la puissance expressive du langageXPath est ici uti Usable. 

Regie XSLT typique 

Une regie XSLT uti I isant I 'instruction xsi :vai ue-of va typiquement avoir la forme : 

<xsl : tempi ate match=" . . . motif (pattern) ..."> 
<!-- modele de transformation --> 

melange de texte et 

d' instructions XSLT de la forme : 

<xsl :value-of select^"... chemin de localisation ..." /> 



<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le nceud 
courant (le noeud en cours detraitement). C'est ce nceud qui fait office de nceud contexte 
dans devaluation du chemin de localisation fourni comme valeur de I 'attri but select. 

Comme son nom I'indique, l'instruction <xsi :vai ue-of seiect=" ..." /> est remplacee 
lors de I 'instanciation du modele par la valeur textuel le de ce qui est designe par I 'attri but 
select. II s'agitdonc de la valeur textuel I e (i.e. sous forme de chaine de caracteres) d'un 
node-set, ou d'un booleen, ou d'un nombre, ou d'une chaine de caracteres, suivant la 
valeur renvoyee lors de I 'evaluation du chemin de localisation. 

Un booleen ou un nombre est converti en chaine de caracteres par appel de la fonction 

string( ). 

U n node- set comportant en general plusieurs nceuds source, sa valeur textuel I e est definie 
comme etantcelledu nceud source qui arrive en premier dans I'ordrede lecture du docu- 
ment. L'instruction est done final ement remplacee par la valeur textuel I e d'un nceud (un 
seul), notion qui aete definie a la section M od<?le arborescent d'un document XM L vu par 
XPath, page 30 et suivantes. 




Les instructions de transformation 



Chapitre 4 



Exemple 



Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 
<xsl:output method='text' encoding='UTF-8'/> 

<xsl : tempi ate match='/'> 

Date Concert : <xsl :val ue-of select="Saison/Concert/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl :templ ate> 

</xsl :stylesheet> 

Appliqueeau fichier saison.xml , cette feuille de style produit le resultat suivant : 



La declaration <xsi:output method='text' encoding='UTF-8'/> permet de specifier 
que I'on veut generer un resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit. Si I'on supprimait cette 
declaration, voici le resultat que I'on obtiendrait : 

<?xml version="1.0" encoding="UTF-8"?> 



Date Concert 
Date Theatre 
Date Theatre 



Samedi 9 octobre 1999 20H30 
Mardi 19 novembre 1999 21H 
Mercredi 20 novembre 1999 21H30 



Date Concert 



Samedi 9 octobre 1999 20H30 
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Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XML genere automatique- 
ment, en contradiction avec la suite du fichier qui n'a pas du tout I 'air d'un fichier XM L. 



Variante syntaxique 

On peut si I'on veut ajouter un attri but disabie-output-escaping a I 'element 
xsi :vaiue-of, commececi : 

<xsl :val ue-of sel ect=" . . . " disable-output-escaping="yes|no" /> 

Cet attri but vaut no par defaut, ce qui veut dire que les caracteres speciaux pour XML 
(comme< ou > ) sontsortis sous forme d'entites caracteres (&it : ou &gt : ). 



Instruction xshapply-templates 

Cette instruction a deja ete largement detaillee (voir Instruction xshapply-templates, 
page 107) : nous nous contenterons d'en indiquer les elements essentiels et les variantes 
syntaxiques. 

Syntaxe 

<xsl :apply-templates /> 

L'instruction xsi :appiy-tempiates ne doit pas apparaitre en tant qu'instruction de pre- 
mier niveau. 

Regie XSLT typique 

Une regie XSLT utilisant l'instruction xsi :appiy-tempiates aura souvent la forme : 

<xsl : tempi ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
. . . texte . . . 
<xsl :apply-templates /> 
. . . texte . . . 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 



Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le nceud 
courant (le noeud en cours de traitement) ; l'instruction <xsi :appiy-tempiates/> est 
remplacee par le fragment de document qui resulte du traitement de la I i ste des enfants du 
noeud courant. Le detail important, ici, est que cette I i ste, que nous avions deja evoquee 
(voir Instanciation d'un module de transformation relativementa un na?ud courant et une 
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liste courante, page 90) est constitute avec les elements enfants du nceud courant, pris 
dans I 'ordre de lecture du document source. 



Exemple 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl : tempi ate match='Saison'> 

Manifestations au programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :template> 

<xsl : tempi ate match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl : tempi ate match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 

</xsl :stylesheet> 

Appliquee au meme fichier Sanson. xmi que celui vu precedemment (voir Exemple, 
page 130), cette feuille de style produit le resultat suivant : 

Manifestations au programme 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 



Theatre : 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 
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Theatre : 

Aristophane 

Mercredi 20 novembre 1999 
Salle des Cordeliers 



21H30 



Reservations 10 jours avant la date. 

Variante syntaxique select="..." 

On peut si I'on veut ajouter un attribut select a I 'element appiy-tempiates , comme 
ceci : 

<xsl :apply-templates select^"... chemin de localisation ..." /> 

L'effet de I 'attribut select est de modifier la constitution de la nouvelle liste de nceuds a 
traiter : en I'absence de seiect=". . .", cette liste contient tous les enfants directs du 
nceud courant ; mais si I 'attribut select est fourni, sa valeur (un chemin de localisation) 
est calculee, cequi donneun node-set, et les elements dece node-set, prisdansl'ordrede 
lecture du document X M L, vont alors constituer la nouvelle liste de nceuds a traiter. 

En principe, le chemin de localisation que I'on fournit pour I 'attribut select fait partie 
des descendants du noeud courant, meme si la specification du langageXSLT n'impose 
pas cette contrainte. En tous cas, c'est une bonne pratique que de se I i miter a ce genre de 
node-set. Si I'on transgresse cette regie de bon sens, on risque d'introduire une recursion 
infiniedans lefonctionnementdu processeurXSLT : 

<xsl : tempi ate match='truc'> 

<xs1 :apply-templates select=". "/> 

</xsl : tempi ate> 

lei, on impose au processeurXSLT une recursion infinie, puisque I 'attribut select selec- 
tionne le noeud courant lui-meme, qui va done indefiniment concorder avec le motif de 
cette regie, indefiniment reactivee. 

Dans I'exemple que nous venons de voir (voir Exemple, page 132), on pourrait vouloir 
faire apparaltre les pieces de theatre avant les concerts ; cela pourrait sefaireainsi : 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 



<xsl : tempi ate match='Saison'> 
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Manifestations au programme 
<xsl :apply-templates select="Theatre"/> 
<xsl :apply-templates select="Concert"/> 
Reservations 10 jours avant la date. 
</xsl :templ ate> 

<xsl : tempi ate match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl :templ ate match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 

</xsl :stylesheet> 

Le resultat obtenu serai t alors le suivant : 

Manifestations au programme 



Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 

Reservations 10 jours avant la date. 



Variante syntaxique mode="..." 

On peut si I 'on veutaj outer un attri but mode a I'element appiy-tempiates , comme ceci : 

<xsl :apply-templates mode="nom-de-mode" /> 

L'emploi de cet attri but va de pair avec la definition de regies XSLT differentes appli- 
cables au meme element source, ces regies etantetiquetees par un nom de mode pour les 
differencier : 

<xsl :templ ate match='...' mode="model"> 
</xsl :templ ate> 

<xsl :templ ate match='... la meme chose mode="mode2"> 
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</xsl : tempi ate> 

Lors de la definition d'un modele de transformation, on peut utiliser instruction 
xsi :appiy-tempiates en precisant le mode choisi, cequi aura poureffetdeselectionner, 
parmi les differentes regies egalement appli cables, celle dont I e mode est egal au mode 
choisi : 

<xsl :apply-templates mode="model" /> 

L a consequence est qu'un meme element peut etre traite pi usieurs fois, par des regies dif- 
ferentes, une par mode. 

C'est cequi distingue la notion de modede celle de priorite : 

• Avec la notion de mode, on introduit volontairement des ambiguites potenti el I es en 
ecrivant pi usieurs regies simultanement eligibles (le plus souvent, el les ont le meme 
motif, mais ce n'est pas obligatoire). Ces regies simultanement eligibles sont asso- 
ciees chacune a des modes differents afin de pouvoir choisir la bonne par I'interme- 
diaire d'une instruction <xsi :appiy-tempiates mode=". . ."/>, qui specifie le mode 
adequat en fonction de I 'instruction en cours. 

• Avec la notion de priorite, on cherche au contraire a eliminer toute ambiguite, en 
affectant une fois pour toutes des priori tes differentes aux regies qui pourraient even- 
tuellement etre simultanement eligibles: a I'execution, si I 'ambiguite se presente, 
c'est toujours la meme regie qui est choisie (celle de plus haute priorite), et toujours 
les memes qui sontecartees. 

En resume, avec la notion de mode, les differents choix possibles restent ouverts 
jusqu'au dernier moment, alors qu'avec celle de priorite, on fermetout des le depart. 



Nous conservons le meme exemple de fichier X M L a traiter ; mais cette fois, imaginons 
que letexte a produiresoit destine a un service municipal qui a notamment en charge de 
prevoi r I e chauffage des sal I es uti I i sees. 0 n veut un texte qui pui sse etre i ntegre dans une 
notede service qui annonce les manifestations a venir, et qui recapitule a la fin les direc- 
tives de chauffage. 

Le probleme ici est qu'un meme element (par exemple <Lieu> ) devra etre traite deux 
fois : une fois en tant que donnee d'une manifestation, et une fois en tant que donnee 
d'une directive de chauffage. 

La solution est de definir deux modes de traitement : un mode « annonce » et un mode 
« logistique ». Le programme XSLT prend la forme suivante : 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 



Exemple 



<xsl:output method='text' encoding='UTF-8'/> 
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<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :templ ate match='Saison'> 
Manifestations a venir 
<xsl :apply-templates select= 
<xsl :apply-templates select= 
Chauffage 

<xsl :apply-templates select= 
<xsl :apply-templates select= 
</xsl :templ ate> 



"Theatre" mode="annonce"/> 

"Concert" mode="annonce"/> 

"Theatre" mode="l ogistique"/> 

"Concert" mode="l ogi stique"/> 



<xsl : tempi ate match='Concert' mode="annonce"> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl : tempi ate match='Theatre' mode="annonce"> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :templ ate> 



<xsl : tempi ate match='Concert' mode="logistique"> 

le <xsl :val ue-of select="Date"/>, <xsl :val ue-of select="Lieu"/> 
</xsl :templ ate> 

<xsl :templ ate match='Theatre' mode="logistique"> 

le <xsl :val ue-of select="Date"/>, <xsl :val ue-of select="Lieu"/> 
</xsl :template> 

<xsl : tempi ate match='Organisation' mode="logistique"> 
</xsl : tempi ate> 



</xsl :stylesheet> 

Le resultat obtenu est alors le suivant : 

Manifestations a venir 



Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Concert : 
Pygmal ion 
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Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 

Chauff age 

le Mardi 19 novembre 1999 21H , Salle des Cordeliers 

le Mercredi 20 novembre 1999 21H30 , Salle des Cordeliers 

le Samedi 9 octobre 1999 20H30 , Chapel 1 e des Ursules 



Instruction xsl:for-each 

Cette instruction est la cousine de xsi :appiy-tempiates, en ce sens que xsi :appiy- 
tempiates etxsi :for-each sontlesdeux seules instructions du langagequi, lors del'ins- 
tanciation du modele qui les heberge, provoquent la creation d'une nouvelle liste de 
nceuds, traitee recursivement (voir I nstanciation d 'un module de transformation relative- 
ment a un na?ud courant et une liste courante, page 90). Bien sur, les effets de ces deux 
instructions sont differents, mais neanmoins, el les declenchent des mecanismes assez 
semblables. 



Bande-annonce 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<0rganisation> Anacreon </0rganisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 
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<xsl : tempi ate match='Saison'> 

<xsl :for-each select="Theatre"> 

Date Theatre : <xsl :val ue-of select="Date"/> 
</xsl :for-each> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 



Syntaxe 



<xsl :for-each select="... chemin de localisation 



."> 



</xsl :for-each> 

L'instruction xsi:for-each ne doit pas apparattre en tant qu'instruction de premier 
niveau. 



Regie XSLT typique 

Une regie XSLT utilisant ^instruction xsi:for-each sera souvent employee comme 
ceci : 

<xsl :templ ate match="... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 



Semantique 



Remarque 

II n'est peut-etre pas inutile de preciser tout d'abord que l'instruction <xsl :for-each> n'est pas une ins- 
truction pour effectuer une boucle, etn'a done rien avoiravec la boucle for (..;..;..) que I'on trouveen C ou 
en Java. En particulier, la notion de compteurqui s'incremente est une notion tres etrangere a XSLT : XSLT est 
un langage qui ne permet pas de faire evoluer la valeur d'une variable ; rappelons que XSLT s'apparente aux 
langages fonctionnels (comme ML ou Caml) lorsqu'il s'agitde faire de I'algorithmique. 
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Lors de I'instanciation du modele englobant, le motif de la regie est en concordance avec 
le nceud courant (le nceud en cours de traitement) ; I'instruction <xsi :for-each>, faisant 
partie de ce modele de transformation englobant, est remplacee par le fragment de 
document qui resulte du traitement de la liste des nceuds selectionnes par son attri but 

select=". . .". instruction <xsl :for-each> est la Seule, avec <xsl :apply-templates>, 

a induire la construction d'une nouvelle liste de nceuds, eta lancer un traitement sur cette 
liste. Commedans la vari ante syntaxi que <xsi :appiy-tempiates seiect=" ...">, la liste 
des nceuds a traiter est etablie d'apres la valeur du chemin de localisation fourni dans 
I 'attri but seiect="...\ En fait, la seule difference appreciable entre <xsi :for-each 

sel ect=" . . . "> et <xsl : apply-templ ates sel ect=" . . . "> est que pour xsl : for-each, 

la regie a appliquer a chaque nceud de la liste n'est pas recherchee parmi I'ensemble 
des regies du programme XSLT, comme dans le cas de <xsi :appiy-tempiates seiect= 
"...">, mais au contraire, lememe model ede transformation est applique uniformement 
achacun d'entre eux. 

Le corps de I'instruction <xsi : for-each> (i.e. I'ensemble des elements fils de I'element 
<xsi : for-each>) constituele model e de transformation uniformement applique achacun 
des nceuds selectionnes, 

Le fragment de document qui resulte du traitement de cette liste est tel que eel a ete defini 
dans le modele de traitement : voir M odele de traitement, page 87. 

Exemple 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl : tempi ate match='Saison'> 

<xsl :for-each sel ect="Theatre"> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 

</xsl :for-each> 
</xsl :templ ate> 

</xsl :stylesheet> 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 
<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 
<Lieu>Chapel 1 e des Ursul es</Lieu> 
</Concert> 
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<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </0rgani sation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 



Autre semantique 

[.'interpretation naturelle de <xsi :for-eacn> est celle d'une instruction permettant la 
repetition d'une meme transformation surplusieurs elements. Bien sfir, pour que ceci ait 
un sens, il faut qu'il y ait effectivement une structure reguliere, repetitive d'elements a 
traiter, et que ce fait soit connu au moment ou I'on ecrit le programme XSLT. 

L'explication de la semantique de cette instruction fait intervenir deux modeles de 
transformation, I'un englobant, I'autre etant le modele de transformation propre au 

<xsl : f or-each> : 

<xsl :templ ate match="... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 

M ais on peut aussi considerer un seul modele de transformation (ce n'est qu'une ques- 
tion de point devue) : 

<xsl :templ ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

... texte ou instructions XSLT ... 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :template> 



</Saison> 



Resultat 



Date Theatre 
Date Theatre 



Mardi 19 novembre 1999 21H 
Mercredi 20 novembre 1999 21H30 
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La seule modification concerne les commentaires : rien n'est done change pour le 
processeur XSLT. Pourtant cette presentation eclaire differemment la semantique du 

<xsl : f or-each>. 

Le modele de transformation est ici vu comme un modele unique, compose de trois par- 
ties : 

<xsl : tempi ate match=" . . . motif (pattern) ..."> 
<!-- modele de transformation --> 
<!-- premiere partie --> 
... texte ou instructions XSLT ... 
<!-- fin premiere partie --> 
<xsl :for-each select=". . ."> 

<!-- deuxieme partie --> 
... texte ou instructions XSLT ... 

<!-- fin deuxieme partie --> 
</xsl :for-each> 
<!-- troisieme partie --> 
... texte ou instructions XSLT ... 
<!-- fin troisieme partie --> 
<!-- fin du modele de transformation --> 
</xsl :template> 

Deslors, le<xsi :for-each> apparait comme une i nstruction qui change temporairement 
lenceud courant pendant I ' i nstanci ati on du modele de transformation, etcepointdevue 
peut etre encore renforce si I 'on imagine que le seiect=" ... • du <xsi :for-each> ne 
selectionnequ'un seul element. 

L'instruction <xsl :for-each> aurait aUSSi bien pu S'appeler <xsl tchange-current- 
node>. 

En effet, lors de I 'i nstanci ati on des premiere et troisieme parties du modele de transfor- 
mation, le motif de la regie est en concordance avec le nceud courant (le nceud en cours 
de traitement). L'instanciation de la deuxieme partie sefait avec un autre nceud courant, 
celui selectionne par I ' attri but seiect=" ..." de I 'instruction <xsi :for-each>. 



Exemple 

On met ici en oeuvre un exemple qui reprend I 'idee du modele de transformation en trois 
partie, la deuxieme donnant lieu a une instanciation relativement a un (ou plusieurs) 
nceud(s) courant(s) different(s) du nceud courant en concordance avec le motif ; lefichier 
XML estlememe: Sanson. xmi (voir Exemple, page 139) 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 
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<xsl : tempi ate match=' Concert '> 
Apres le concert 

<xsl :value-of select="Organisation"/> du <xsl :val ue-of select="Date"/>, 
il y aura encore les spectacles suivants : 
<xsl :for-each select="/Saison/Theatre"> 

Theatre (<xsl :value-of select="Organisation"/>) , 

le <xsl : val ue-of sel ect="Date"/> 
</xsl :for-each> 
Rappel des sal les : 
<xsl :val ue-of select="Lieu"/> 
</xsl :template> 

<xsl :template match='Organisation'> 
</xsl :templ ate> 

<xsl : tempi ate match='Date'> 
</xsl :templ ate> 

<xsl :template match='Heure'> 
</xsl :templ ate> 

<xsl : tempi ate match=' Lieu'> 

<xsl :value-of select="."/> 
</xsl :templ ate> 

</xsl :stylesheet> 

La premiere regie, dont le motif concorde avec lenoeud <concert>, declare un modelede 
transformation en trois parties. 

Premiere parti e 

Apres le concert 

<xsl : val ue-of select="Organisation"/> du <xsl :val ue-of select="Date"/>, 
il y aura encore les spectacles suivants : 

Deuxieme parti e 

I Theatre (<xsl :value-of select="Organisation"/>) , 
le <xsl :val ue-of sel ect="Date"/> 

Troisieme parti e 

Rappel des sal les : 

<xsl :val ue-of select="Lieu"/> 

La premiere et la troisieme seront instanciees relativement au nceud courant <concert>, 
alors que la deuxieme sera instanciee plusieurs fois, relativement a differents noeuds cou- 
rants (successivementtous les elements <Theatre> enfants de la racine <saison>). 

Leresultat est qu'achaque fois, les instructions 

<xsl :value-of select="0rganisation'7> 
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et 

<xsl :val ue-of select="Date"/> 

de cette deuxieme partie sont instanciees differemment en fonction du noeud courant 
actif. La troisieme partie est instanciee sous la forme : 

Rappel des salles : 
Chapelle des Ursules 

etc'estla regie 

<xsl : tempi ate match=' Lieu'> 

<xsl :val ue-of select="."/> 
</xsl : tempi ate> 

qui complete la liste des salles. Appliquee au fichier saison.xmi, cette feuille de style 
produit le resultat suivant: 

Apres le concert Anacreon du Samedi 9 octobre 1999 20H30 

il y aura encore les spectacles suivants : 

Theatre ( Masques et Lyres ), le Mardi 19 novembre 1999 21H 

Theatre ( Masques et Lyres ), le Mercredi 20 novembre 1999 21H30 

Rappel des salles : 
Chapelle des Ursules 



Salle des Cordeliers 



Salle des Cordeliers 

La mise en page, et notamment la repartition des sauts de ligne n'est pas extraordinaire, 
mais nous verrons plus loin comment regler ce genre de probleme. 

Cet exemple met en jeu les regies par defaut, puisqueaucune regie n'estfournie pour les 

elements <Saison> et <Theatre>. 

Pour I 'element <saison> la regie 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl : tempi ate> 

s'applique, et relance le traitement sur les nceuds enfants <concert>, <Theatre>, et 
<Theatre>. Pour I 'element <concert> une regie explicite est fournie. Pour les elements 
<Theatre> la regie par defaut 
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<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 

s'applique, et relance le traitement sur les noeuds enfants <organisation>, <Date>, et 
<Lieu>, ces elements etant pris en charge par des regies expli cites. 



Instruction xshsort 

Bande-annonce 

L'instruction xsi :sort est une instruction de tri qui ne s'emploie que comme comple- 
ment a xsi :appiy-tempiates ou xsi :for-each : elle sert a trier le node-set selectionne 
par I'une de ces deux instructions. L'exemple ci-dessous montre un xsi :sort accompa- 

gnant un xsi :for-each. 
CDtheque.xml 

<?xml version="1.0" encoding="UCS-2" standalone="yes"?> 
<CDtheque> 

<Compositeurs> 

<Compositeur> 

<nom> Couperin </nom> 

<prenom> Louis </prenom> 

<actifVers> 1670 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Thomas </prenom> 

<actifVers> 1610 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Faugues </nom> 

<prenom> Guillaume </prenom> 

<actifVers> 1460 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Aristophane </nom> 

<prenom> f 11 s de Philippos d'Athenes </prenom> 
<actifVers> -410 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Christopher </prenom> 
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<actifVers> 1640 </actifVers> 
</Compositeur> 

</Compositeurs> 

</CDtheque> 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort sel ect="nom"/> 
<xsl :value-of sel ect="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat 

Aristophane Couperin Faugues Simpson Simpson 

Variantedetri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 

<xsl:sort sel ect="acti fVers" data-type="number"/> 
<xsl :value-of select="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat 

Aristophane Faugues Simpson Simpson Couperin 

Syntaxe 

<xsl :sort/> 

L'instruction xsi rsort nedoit pas apparaitre en tant qu'instruction de premier niveau, et 
doitapparaitre dans le modelede transformation d'un xsi :for-eacn ou d'un xsi :appiy- 

templ ates. 
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Regie XSLT ty pique 

Une regie XSLT uti I isant I 'instruction xsl :sort sera souvent employee comme ceci : 

<xsl : tempi ate match="... motif (pattern) ..."> 

<xsl :for-each select=" . . . "> 
<xsl :sort/> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

</xsl :templ ate> 

ou encore comme ceci : 

<xsl : tempi ate match="... motif (pattern) ..."> 

<xsl :apply-templates> 

<xsl :sort/> 
</xsl :apply-templates> 

</xsl : tempi ate> 

Semantique 

L'instruction <xsi :sort/> ne s'emploie pas seule ; el I e est en fait liee aux deux instruc- 
tions <xsi : for-each> et <xsi :appiy-tempi ates>, et ne peut s'employer autrement que 
commeassocieea I'unedecesdeux instructions. 

En I'absence d'une instruction <xsi:sort/>, les deux instructions <xsi :for-each> et 
<xsi :appiy-tempiates> constituent une liste des elements a traiter, basee sur I'ordre 
naturel de lecture du document XML. 

L'instruction <xsi :sort/> intervient done pour modifier I'ordre des elements de cette 
liste : par defaut (e'est-a-dire en I'absence d'attributs propres a <xsi :sort/> permettant 
de specifier les parametres du tri a effectuer), les elements de cette liste sont ordonnes 
suivant I'ordre lexicographique de la valeur textuelle de chaque element. 

L'instruction <xsi :sort/> est touj ours vide; elle peut juste etre completee par differents 
attributs que nous verrons plus loin. 

Utilisee en association avec <xsi :for-each>, elle doit necessairement se trouver placee 
avantle debut du model ede transformation inclusdansce<xsi :for-each>, comme on le 
voit dans I'exemple ci-dessus. 

Note 

Employee dans un xsl :for-each la fonction positiont ) renvoie le numero d'ordre du nceud courantau sein 
du node-set selectionne par I'attribut select du xsl :for-each. Si cette instruction xsl :for-each comporte 
une instruction xsl :sort, la numerotation consideree estcelle du node-set reordonne parle tri. 
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Exemple 

Nous reprenons I 'exemple relatif a I'instruction <xsi :appiy-tempiates> , tel qu'il est 
traite a la section Instruction xsl : apply-templates, page 131. Le fichiers XML est le 
memequecelui deja utilise comme exemple (voir Exemple, page 132) : 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Pygmalion </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Aristophane </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Le fichier XSLT est lui aussi le meme, a ceci pres que I 'on ajoute une instruction 

<xsl : sort/> a I' instruction <xsl : apply- tempi ates> : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :template match='Saison'> 
Manifestations aii programme 

<xsl :apply-templates> <xsl:sort/> </xsl :apply-templates> 
Reservations 10 jours avant la date. 
</xsl :templ ate> 

<xsl :template match='Concert'> 

Concert : <xsl :value-of select="."/> 
</xsl :templ ate> 

<xsl :template match='Theatre'> 

Theatre : <xsl :value-of select="."/> 
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</xsl :templ ate> 
</xsl :stylesheet> 
Resultat 



Manifestations au programme 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapel 1 e des Ursules 

Reservations 10 jours avant la date. 

Nous reprenons le deroulement du processus de traitement sur cet exemple (voir Consti- 
tution d'une liste ne contenant que la racine, page 108), qui ne change en rien, sauf une 
fois arrive a I'etape representee par la figure 3-21, que I 'on rappelle ici (voir figure 4-1). 

Sans instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I 'ordre de lecture du document. 

Avec instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I 'ordre lexicographique de la valeur textuelle des ele- 
ments (voir figure 4-2). 

La valeur textuelle des trois elements <Theatre/>, <Theatre/>, <concert/> est obtenue 
comme explique a la section Nceud de type element, page 31, et aux figures 3-23, 3-25, 
3-27 de la section Instanciation du module de transformation, page 118. Ici, les mots 
Pygmalion, M asques et Lyres, Aristophane imposent leur ordre lexicographique a leurs 
trois elements respectifs. 
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M odele 



M anifestations au programme 



recopie 



<xsl : appl y-templ ates/> 



remplace par sa valeur 
(l)+(2)+(3)+(4)+(5) 



Fragment de 
document resultat 

M anifestations au programme 



Reservations 10 jours avant la date. 



Traitement 
(2)+(3)+(4)+(5) 



recopie 



Pygmalion 

Samedi9 0ctobrel999 20H30 
ChapelledesUrsules 



A ristophane 

M ercredi 20 Novembre 1999 21H3C 
SalledesCordeliers 



Reservations 10 jours avant la date. 



Generation d'une 
nouvdleliste 
(1) 



Listeii traiter 



Concert 



T heatre 



T heatre 
— •- 



i 
i 

Traitement 
du noeud 
Concert 
(2) 



Concert: 
Pygmalion 

Samedi 9 0ctobrel999 20H30 
ChapelledesUrsules 



i 
i 

Traitement 
du noeud 
Theatre 
(3) 



Theatre : 

M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 



i 
i 

Traitement 
du nceud 
Theatre 
(4) 



Theatre : 
Aristophane 

M ercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



Concatenation 
(5) 



Figure 4-1 

Instanciation du modele de transformation (sans <xsl:sort/>). 
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M odele 



M anifestations au programme 



recopie 



<xsl:apply-templates> 

<xsl :sort/> 
</xsl:apply-templates> 



remplace par sa valeur 
(l)+(2)+(3)+(4)+(5) 



Reservations 10 jours avant la date. 



Generation d'une 
nouvelleliste 
ordonnee 
lexicographiquement 
(1) 



L iste a traiter 



Theatre 
• — 



Theatre 
— • — 



Traitement 
du nceud 
Theatre 
(2) 



Traitement 
du nceud 
Theatre 
(3) 



Traitement 
(2)+(3)+(4)+(5) 



recopie 



Concert 



Traitement 
du noeud 
Concert 
(4) 



Theatre : 




Theatre : 




Concert : 


A ristophane 




M asques et Lyres 




Pygmalion 


Mercredi20Novembrel999 21H30 




Mardi 19 Novembre 1999 21H 




Samedi9 0ctobrel999 20H30 


Sailedes Cordeliers 




Sailedes Cordeliers 




Chapelledes Ursules 



Fragment de 
document resultat 



M anifestations au programme 



A ristophane 
Mercredi 20 N over 
Sailedes Cordelier 



Samedi9 0ctobrel999 20H30 



Reservations 10 jours avant la date. 



Concatenation 
(5) 



Figure 4-2 

I nstanciati on du module de transformation (avec <xsl:sort/>). 
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Variantes syntaxiques 

On peut, si I'on veut, ajouter a I 'instruction <xsi :sort/> les attributs suivants : 

<xsl:sort sel ect=" . . . " orders"..." 

case-order=" . . . " lang="..." data-type=" . . . "/> 

Ces attributs permettent de preciser les differents parametres du tri, que nous all ons 
maintenant passer en revue. 

Attribut select 

Signification 

L' attribut select est essentiel, car il definit la cle de tri, c'est-a-dire la chalne de carac- 
teres a extrairede I 'element en cours de placement, sur laquelle portera letri. 

Valeur possible 

On peut fournir une expression XPath quelconque, qui est evaluee, comme il se doit, 
relativement a un noeud contexte et a une liste contexte. 

Le noeud contexte est le noeud en cours de placement, et la liste contexte est la liste de 
noeuds (conservee dans son etat originel), produite par I 'instruction directement englo- 
bante, c'est-a-dire, suivant les cas, soit par I 'instruction <xsi :appiy-tempiates/>, soit 

par instruction <xsl :for-each/>. 

Cette expression ne donne pas forcement une chalne de caracteres comme resultat (on 
obtient meme un node-set dans le cas le plus general), mais s'il le faut, la fonction 
stringo lui est appliquee, et la chalne de caracteres qui en resulte constitue alors la cle 
detri. 



Note 

II y a en fait deux listes en jeu : celle avant et celle apres le tri. Le fait que la liste contexte soitcelle conservee 
dans son etat originel, done avant le tri, rend possible ('utilisation de la fonction positionf) au sein de I'expression 
XPath. 

Valeur par defaut 

La valeur par defaut est egale a stringo, qui n'estrien d'autre que la valeur textuelle 
du noeud courant. 

Autres attributs 

Les autres attributs sont des parametres qui permettent de regler la facon dont le tri est 
effectue. 

• order 

L 'attribut order definit I 'ordre du tri (ascendant ou descendant) ; il peut prendre I 'une 

des deux valeurs ascending OU descending, et Sa valeur par defaut est ascending. 
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Note 

Techniquement, sontacceptees ici des valeurs d'attribut ordinaires (des chaTnes de caracteres, comme on en a 
I'habitude), mais aussi, etde fagon assez exceptionnelle en XSLT, des Attribute Value Template, notion qui sera 
introduite beaucoup plus loin (voir Descripteur de valeur differee d'attribut (Attribute Value Template), page 269). 

Mais on pourra ignorercette remarque en premiere lecture, puisque les valeurs d'attributs ordinaires sontaccep- 
tees. 



• case-order 

L'attri but case-order deflnit la relation d'ordre entre les lettres minuscules et majus- 
cules ; il peut prendre I 'une des deux valeurs upper-first ou lower-first, etsa valeur 
par defaut depend de la langue utilisee. 

• lang 

L'attri but lang deflnit la langue utilisee, et par la meme, les conventions detri propres 
a cette langue ; sa valeur est un des codes de langue deflnit par X M L , et sa valeur par 
defaut depend de I'environnementdetraitement. 

• data-type 

L'attri but data-type deflnit la nature de la cle, afln de savoir comment comparer deux 
cles. Essentiellement, cette nature peut etre de type texte (comparaison de chalnes de 
caracteres) ou numerique (comparaison denombres) ; sa valeur est done soittext, soit 
number. Une autre valeur possible est un code special propre a une implementation 
particul iere de XSLT, qui offre cette valeur en extension, et indique naturellement ce 
qu'elle signifie. On peut penser qu'un code date seraittres utile, car rien n'a ete prevu 
en standard pour comparer des dates lors d'un tri, alors que ni text ni number ne 
conviennent. 

La valeur par defaut est "text". 
Exemple 

On dispose d'une base de donnees de CDtheque, constitute d'informations sur les com- 
positeurs, lesceuvres, les enregistrements, etc. 

U n extrait de cette base pourrait ressembler a ceci : 
CDtheque .xml 

<?xml version="1.0" encoding="UCS-2" standalone="yes"?> 

<CDtheque> 

<Compositeurs> 

<Compositeur> 

<nom> Couperin </nom> 
<prenom> Louis </prenom> 
<actifVers> 1670 </actifVers> 
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</Compositeur> 



<Compositeur> 

<nom> Simpson </nom> 
<prenom> Thomas </prenom> 
<actifVers> 1610 </actifVers> 

</Compositeur> 



<Compositeur> 

<nom> Faugues </nom> 
<prenom> Guillaume </prenom> 
<actifVers> 1460 </actifVers> 

•(/Compositeur) 



<Compositeur> 

<nom> Aristophane </nom> 

<prenom> fils de Philippos d'Athenes </prenom> 
<actifVers> -410 </actifVers> 
</Compositeur> 



<Compositeur> 

<nom> Simpson </nom> 

<prenom> Christopher </prenom> 

<actifVers> 1640 </actifVers> 

</Compositeur> 



</Compositeurs> 



</CDtheque> 

Pour editer les compositeurs par ordre alphabetique de leur nom, on peutecrire la feuille 
destylesuivante : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl :val ue-of sel ect="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Le resultat obtenu est le suivant : 

Aristophane Couperin Faugues Simpson Simpson 



■ Les instructions de transformation 

| Chapitre 4 

Letri sefaitici avec toutes les valeurs par defautdes attributs order, case-order, lang, 

et data-type. 

Supposons maintenant que nous voulions faire un tri par les dates, nous pouvons alors 
extraire lecontenu de I 'element <actifvers> pour en faire une cle de tri. A fin de mon- 
trer la difference entre tri numeriqueettri alphanumerique, nous avons ajoute une entree 
« Aristophane » dans le fichier XML donne. 

Note 

Aristophane etaitun Grec, actif vers le iv e siecle avantj C, qui nous a laisse un peu de musique, gravee surdes 
dalles de marbre conservees a Delphes. Cette musique a reellementete enregistree surCD (plus recemment). 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl rstylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Coinpositeur"> 

<xsl:sort select="actifVers" data-type="number"/> 
<xsl :val ue-of select="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Leresultatobtenu estlesuivant: 

Aristophane Faugues Simpson Simpson Couperin 

On remarquera que ce qui est appele ici tri sur les dates est en fait un tri sur des entiers, 
car il n'y a pas encore, en XSLT, de typededonnee normalise correspondant a une date. 

Si on avait omis de preciser I 'attri but data-type, sa valeur par defaut (text) aurait ete uti- 
I i see, ce qui aurait donne le resultat suivant : 

Faugues Simpson Simpson Couperin Aristophane 

Tri a cles multiples 

II estpossiblede preciser pi usieurs cles de tri : quand deux elements ontmeme valeur par 
la premiere cle de tri, on les departage avec la deuxiemecle, et ainsi de suite. Dans notre 
exemple, on peut utiliser une deuxieme cle de tri sur le prenom, pour affiner le tri sur le 
nom qui donne un doublon (Simpson). 

Voyons ce que donne I 'edition du nom + prenom sans cle detri secondaire (remarquer la 
presence d'un « » : « » xsl: value-of ) : 
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CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl :val ue-of sel ect="nom"/> 
<xsl :value-of select="prenom"/>; 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Le resultat obtenu est le suivant : 

Aristophane f 11 s de Philippos d'Athenes ; 
Couperin Louis ; 
Faugues Guillaume ; 
Simpson Thomas ; 
Simpson Christopher ; 

Nous necherchons pas pour I 'instant a expliquer la presentation obtenue, notamment la 
presence des sauts de ligne, qui ne se manifestaient pas dans les exemples precedents. 

On observe que les deux Simpson ne sont pas classes dans I'ordre de leur prenom. On 
ajoute alors une deuxieme cle de tri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl:sort sel ect="prenom"/> 
<xsl :val ue-of sel ect="nom"/> 
<xsl :value-of select="prenom"/>; 
</xsl : for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Le resultat obtenu est I e suivant: 

Aristophane fils de Philippos d'Athenes ; 
Couperin Louis ; 
Faugues Guillaume ; 
Simpson Christopher ; 
Simpson Thomas ; 
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Instruction xsl:copy-of 

Cette instruction est la cousine de <xsi :vaiue-of/> ; mieux : partout oil <xsi :vaiue- 
of/> est utilisee, on pourrait la remplacer par <xsi :copy-of/> sans que cela change le 
resultat obtenu. Bien sur, la reciproque est fausse, et remplacer une occurrence quel- 
conquede <xsi :copy-of/> par <xsi :vaiue-of/> peut changer I e resultat. 



Bande-annonce 

instruction <xsi:copy-of seiect=". . ."/> est instanciee sous la forme d'une copie 
conforme des elements selectionnes. 



Concert .xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 



<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<l_ieu>Chapelle des Ursules</I_ieu> 

<Interpretes> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Interpretes> 



</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'xml ' encoding=' ISO-8859-1' indent='yes' /> 



<xsl :template match=" Interpretes"> 
<Musiciens> 

<xsl :copy-of select="Interprete"/> 
</Musiciens> 
</xsl :template> 

<xsl :template match="text( )"></xsl :template> 



</xsl :stylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Musiciens> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Musiciens> 

Syntaxe 

<xsl :copy-of select="... chemin de localisation ..."/> 

L'instruction xsi:copy-of ne doit pas apparaftre en tant qu'i nstruction de premier 
niveau. 

Regie XSLT typique 

UneregleXSLT utilisant I 'instruction xsi :copy-of sera souvent employee commececi : 

<xsl : tempi ate match="... motif (pattern) ..."> 

<xsl:copy-of sel ect=" . . . "/> 
</xsl :templ ate> 

Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le nceud 
courant (le noeud en cours detraitement). C'estce nceud qui fait office de nceud contexte 
dans devaluation du chemin de localisation fourni comme valeur de I ' attri but select. 

L'instruction <xsi :copy-of>, comme son nom I'indique, effectue une copie du resultat 
de devaluation du chemin de localisation. 

Si ce resultat est une chaine de caracteres, un booleen, ou un nombre, xsi :copy-of et 
xsi : vai ue-of ont exactement le meme effet (voir Semantique, page 129). 



Si le resultat est un node-set, I ' effet est tres different: le node-set est serialise. 
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La serialisation d'un node-set est une operation tres simple (malgre son nom un peu 
impressionnant), qui a pour resultat un fragment de document constitue de la juxtaposi- 
tion (ou concatenation) des fragments de documents obtenus en serial isant successive- 
ment chacun des nceuds du node-set, pris dans I'ordre de lecture du document source 
(voir figure 4-3). 



root A 



Interpretes 



node-set 




ordre de 
lecture du 
document 



Serialisation 



Interprets 



Nora Instrument 



Jonathan Basse S ilvia Basse 

Dunford de viole Abramowicz de viole 



<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstrument> 

<Vlnterprete> 

<lnterprete> 
<Nom> Silvia Abramowicz <Nom> 
<lnstrument> Basse de viole <lnstrument> 

<lnterprete> 



Serialisation 



<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstmment> 

</lnterprete> 



Serialisation 



<lnterprete> 
<Nom>Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 

</lnterprete> 



Figure 4-3 

Serialisation d 'un node-set. 



Concatenation 



La serialisation d'un nceud, quant a el I e, est une operation encore plus simple qui 
consiste a voir ce nceud en tant que racine d'un sous arbre, et a serialiser ce sous-arbre. 

Nousavonsdejavu cela, (voir Construction - serialisation, page 84) mais rappelons que 
la serialisation d'un arbre (ou d'un sous-arbre), est I 'operation inverse de sa construction 
a partir d'un document (ou d'un fragment de document) : la construction prend un (frag- 
ment de) document etcree I e (sous) arbre equivalent; la serialisation redonne I e (fragment 
de) document d'origine (voir figure 4-4). 
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Figure 4-4 

Serialisation 
d'un arbre. 



DocumentXML 
<Concert> 

<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstrument> 
<yinterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 
<yinterprete> 
</lnterpretes> 
</Concert> 

Construction 



Serialisation 





^root 




^Concert 


Date 
• 


Lieu Interpretes 
• • 


Jeudi 17 J ariuier 2002. 20H30 


Interprete Interprete 

Norn Instrument Nom Instrument 
• • • • 

J onathan Dunford Basse de viole Silvia Abramowicz Basse de viole 



Arbre XML du document 



Remarque 

Si Ton raisonne en terme d'arbre XML etnon pas en terme de document, il est equiva lent de dire que I'instruction 
<xsl :copy-of> provoque un duplicata recursif d'un ensemble de sous-arbres : chaque nceud du node-set est 
duplique de telle sorte qu'il soit recursivement identique au nceud original ; on obtient alors un duplicata certifie 
conforme de chacun des sous arbres ayantpourracines les nceuds originauxdu node-set de depart. 
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Note 

Deux nceuds recursivement identiques sontdeux nceuds que rien ne permetde distinguer :ils ontles meme attrl- 
buts, les memes namespaces, et les memes nceuds enfants, qui sont eux-memes recursivement identiques 
deux a deux. 

Exemple trivial 

Cet exemple explicite la programmation dela serialisation (montreea la figure 4-3). II est 
trivial en ce sens qu'il ne fait rien de tres interessant. 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instmment>Basse de viole</Instrument> 
</Interprete> 
</Interpretes> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xml ' encodings' ISO-8859-1' indent='yes' /> 

<xsl :template match="Interpretes"> 
<Musiciens> 

<xsl :copy-of select="Interprete"/> 
</Musiciens> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "></xsl : tempi ate> 



</xsl :stylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Musiciens> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Musiciens> 



Autre exemple 

Etant donne que ('instruction <xsi :copy-of> sert a dupliquer un (ou des) sous arbre(s) 
XML, il semble assez evident qu'elle sera surtout utile lors de transformations XML 
versXM L. II y a neanmoins un autre cas d'utilisation assez frequent, des lors que Ton 
manipule des variables. On en verra des exemples a la section Pattern n°2 - Fonction, 
page 396. 

Dans I'exemple qui suit, il s'agit d'expurger un document XML, pour en retirer de 
I 'information : 

BaseProduits .xml 

<?xml version="1.0" encoding="UCS-2" standal one="yes"?> 
<BaseProduits> 

<LesProduits> 

<Livre ref="vernesl" NoISBN="193335" gamme="roinan" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"X/Prix> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre 

ref="boileaunarcejacl" NoISBN="533791" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 
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<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Li vre> 

<Enregistrement 

ref="maraisl" Ref Editeur="LC000280" gamme="violedegambe" media="CD"> 
<refOeuvres> 

<Ref valeur="marais.folies"/> 

<Ref valeur= "ma rais. pieces 1685 "/> 
</refOeuvres> 
<Interpretes> 

<Interprete nom=" Jonathan Dunford"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete nom="Sylvia Abramowicz"> 

<Role xml :lang="fr"> Basse de viole </Role> 

<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Benjamin Perrot"> 

<Role xml :lang="fr"> Theorbe et guitare baroque </Role> 
<Role xml :lang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Freddy Eichelberger"> 

<Role xml :lang="fr"> Clavecin </Role> 

<Role xml :1 ang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 

<Titre xml :lang="fr"> Les Folies d'Espagne et pieces inedites </Titre> 
<Titre xml :lang="en"> Spanish Folias and unedited music </Titre> 
<Prix valeur="140" monnaie="FF"/> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 

<Materiel 

ref="HarKarl" refConstructeur="XL-FZ158BK" 
gamme="lecteurCD" marque="HarKar"> 
<refCaracteristiques> 

<Ref valeur="caracHarKarl"/> 
</refCaracteristiques> 
<Prix valeur="4500" monnaie="FF"/> 
<Prix valeur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<!-- ... etc : le fichier continue avec d'autres elements --> 
</BaseProduits> 
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Ce fichier XML rassemble des elements d'une base de donnees de produits, et I 'on veut 
ecrire un programme XSLT permettant de creer un fichier des livres uniquement. 

Rien de plus simple : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xinl ' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl : tempi ate match="/"> 
<Livres> 

<xsl :apply-templates/> 
</Livres> 
</xsl :template> 

<xsl :template match="Livre"> 
<xsl:copy-of select="."/> 
</xsl :template> 

<xsl :template match="text( )"></xsl :template> 
</xsl :stylesheet> 

Etvoici cequ'on obtient : 
livres.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Li vres> 

<Livre ref="vernesl" NoISBN=" 193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 
</Livres> 

Dans I 'instruction : 

<xsl:output method='xml' encoding=' ISO-8859-1 ' indent='yes' /> 
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I 'attri but indent permet d'obtenir une indentation (pas tres convaincante, il est vrai) ; si 
on I'avait omis, voici ce qu'on aurait obtenu : 

1 i vres .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<LivresXI_ivre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix val eur="40. 5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Li vreXLi vre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" 
media="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</LivreX/Livres> 

A u fait, pourquoi avoir integre a ce programme XSLT la regie montreeci-dessous ? 

<xsl :template match="text( ) "></xsl :template> 

Pour voir son utilite, commencons par voir ceque I'on obtiendrait si on la supprimait : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl: output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl : tempi ate match="/"> 
<Livres> 

<xsl :apply-templates/> 
</Li vres> 
</xsl : tempi ate> 

<xsl : tempi ate match="Livre"> 
<xsl:copy-of select="."/> 
</xsl : tempi ate> 

</xsl :stylesheet> 

1 i vres .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Livres> 
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<Livre ref="vernesl" NoISBN=" 193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 



<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 



Basse de viole 
Bass Viol 



Basse de viole 
Bass Viol 



Theorbe et guitare baroque 
Theorbo and baroque guitar 



Clavecin 
Harpsichord 



</Livre> 



</Livre> 



Les Folies d'Espagne et pieces inedites 
Spanish Folias and unedited music 
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</Livres> 

Ce fatras de textes (apres la derniere balise fermante </iivre>) et de lignes blanches 
intempestives fait reellement partiedu resultatobtenu ; c'estla regie par defaut 

<xsl : tempi ate match="text( ) "Xxsl : val ue-of sel ect=" . VX/xsl : tempi ate> 

qui en est responsable. 



5 



Les instructions 
de programmation 



Les instructions de programmation sont des instructions qui permettent, soit de condi- 
tionner I'instanciation d'un modele de transformation a la valeur d'une expression boo- 
leenne, soit de manipuler des variables, des parametres, et des model es nommes (named 
templates) qui font office decequ'on appel lerait fonction dans des langagescommeC ou 
Java. C'estmaigre, a premiere vue. Pas de boucles de repetition d'aucune sorte (on rap- 
pel I e que I 'instruction xsl:for-each n'est pas une boucle au sens algorithmique du terme, 
voir Instruction xsl : for-each, page 137), aucune possibility de faire evoluer la valeur 
d'une variable (adieu compteurs, incrementations, effets de bord, et toutes ces sortes de 
chosesqui font partie des canons de la programmation en C) ; pas de boucle, done encore 
moinsde break, et pas plus de return pour sortir prematurement d'une fonction, pardon, 
d'un modele nomme. Cote structures dedonnees, e'est encore pi re: pas de tableaux, pas 
de struct comme en C ou de ci ass comme en J ava, pas de listes, pas de hash-tables, ni 
quoi que ce soit d'autre. Ah, si ! II y en a une : la structure d'arbre de type RTF (Result 
Tree Fragment) ; mais pas de chance, e'est une WOM (Write Only M emory) : on peuty 
ranger des elements, mais on nepeutlesy retrouver individuellement... 

Dans ces conditions, comment peut-on encore vouloir programmer quoi que ce soit avec 
un tel langage ? Autant vouloir percer un mur avec un tire-bouchon. 

Et pourtant ... Lecroirez-vous? XSLT estun langage Turi ng-complet , comme disent les 
savants. 

Alan Turing etait un mathematicien anglais, qui dans les annees 1936-1937, a fonde la 
theorie de la calculabilite (qui a pour objet de savoir si toute fonction est calculable, ce 
qu'est une fonction calculable, etc.). II a defini cequ'on appelle aujourd'hui une machine 
de Turing, qui, par definition de la calculabilite, peut calculer tout ce qui est calculable en 
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un nombre fini cooperations. Un langageTuring-complet est un langageavec lequel on 
peut programmer tout ce qu'une machine de Turing peut calculer, c'est-a-dire tout... ce 
qui est calculable. 

On a du mal a lecroire, apres le resume des prouesses deXSLT en la matiere. M ais c'est 
pourtant vrai. 

En effet, les model es nommes (ou fonctions) peuvent etre appeles recursivement ; il y a 
la possibilite de tester une condition avec I'instruction xsi:if ; enfin on peut se 
debrouiller pour bricoler une structure de tableau, en la construisantcommeun arbre, que 
Ton convertitensuiteen chaine de caracteres, I'acces aux elements sefaisant en I'explo- 
rant grace aux fonctions XPath predefines (notamment substring, substring-after, 
substring-before). Or, il estconnu qu'on peut tout programmer en disposantseulement 
de tableaux, de la recursion, et de tests. C'est done vrai qu'on peut tout programmer en 
XSLT. M ais il est evidemment hors de question de programmer quoi que soit dans ces 
conditions : c'est totalement inutilisable en pratique, sauf eventuellement pour des traite- 
ments extremement simples. 

Heureusement, dans la real ite, la situation est un peu meilleure : en effet, la plupart des 
processeurs XSLT disponibles offrent une extension sous forme d'une fonction de 
conversion, qui permet de convertir le type RTF en vrai node-set ; du coup, on peut lui 
appliquer n'importe quelle expression XPath, et done extraire nominativement et com- 
modement route information i ndi vi duel I e qui s'y trouve. 

Cela change enormement la puissance du langage en terme de programmation, car on 
peut des lors construire des structures de donnees aussi complexes que I 'on veut (et pour 
cela, un arbre n'est pas un mauvais choix), et recuperer les informations stockees sans 
difficult particuliere. 

De plus, ce qui pour I'instant (par rapport a XSLT 1.0) est une extension indispensable, 
devrait bientot devenir une extension inutile : en effet, la prochaine version de XSLT 
(XSLT 2.0) prevoit d'unifier les notions de RTF et de node-set, rendantainsi caduquela 
fonction deconversion RTF vers node-set. 



Note 

II existe une version intermediaire, XSLT 1.1, mais qui est et restera sous forme de Working Draft : il n'y aura 
jamais de Recommendation XSLT 1.1, parce les evolutions prevues parle Working Draft 1.1 ne sontpas mi- 
neures, et risquentde restreindre le champ d'investigation des travaux sur la 2.0, tantque ces derniers ne seront 
pas suffisammentavances pourqu'il soit possible de comprendre finementles implications de Pheritage impose 
par un Working Draft 1. 1 promu au rang de Recommendation. Les travaux sur le Working Draft 1.1 ont done ete 
interrompus, etles propositions devolution qu'il prevoyaitontete incorporees aux propositions devolution pour 
la 2.0. 

Ceci dit, il reste vrai que la programmation en XSLT n'est pas une chose tres aisee, 
d'abord parce que c'est une programmation fonctionnelle pure, done assez etrangere, en 
general, a ce qui nous est familier ; ensuite parce que le langage est extremement spar- 
tiate (on peut difficilement imaginer un langage plus minimaliste) ; enfin parce que la 
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bibliotheque de fonctions predefines n'est pas tres developpee (encore que cela puisse 
evoluer dans les prochaines versions). 

Audemeurant, il fautresterconscientqueXSLT n'est pas un langageconcu pourfairede 
I'algorithmique, mais pour faire des transformations d'arbres XML, chose qu'il fait 
extremement bien, reconnaissons-le (a tel point que lorsqu'on a un stock de donnees 
informelles a traiter, quelles qu'elles soient, se pose desormais la question de savoir s'il 
ne vaudrait pas mieux commencer par structurer ses donnees en XM L, puis de les sou- 
mettre a une transformation XSLT, plutot que d'ecrire un programme ad-hoc en C ou 
Java). II fautdonc plutot voir les possi bi I ites de programmation comme des complements 
a la manipulation et la transformation d'arbres XM L, et sous cet angle, il est incontes- 
table que ces complements decuplent la puissance du langage de transformation. 

Instruction xshif 

Bande-annonce 

<xsl :template match="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :apply-templates/> </H3> 
</xsl : tempi ate> 

<xsl :template match="Compositeur"> 
<xsl :val ue-of select="."/> 

<xsl:if test="not(position( ) = last())">, </xsl:if> 
</xsl : tempi ate> 

Cet exemple montre une instanciation conditionnelle d'une partie d'un modele de trans- 
formation : une virgule est ajoutee a la valeur textuelle du noeud courant, sauf si c'est le 
dernier de la liste constitute par <xsi :appiy-tempiates/>. On obtient ainsi une liste 
d' items separes par des virgules. 

Syntaxe 

xsl :if 

<xsl:if test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :if> 

L'instruction xsi :if nedoit pas apparaltre en tant qu'instruction de premier niveau. 

Regie XSLT typique 

Une regie XSLT uti I isant I 'instruction xsi :if sera souvent employee comme ceci : 

<xsl :template match="... motif (pattern) ..."> 
<xsl:if test=" ... expression XPath ... "> 




Les instructions de programmation 



Chapitre 5 



<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 



</xsl :if> 



</xsl :templ ate> 



Semantique 

L'expression XPath fournie en tant que valeur de I 'attri but test est evaluee, et sa valeur 
est eventuellement convertie en booleen s'il le faut, en lui appliquant la fonction 
booieano. Rappelons (voir sectionboolean true(), page 636) que cette fonction renvoie 
true si et seulement si son argument est un nombre non nul, ou une String de longueur 
non nulle, ou un node-set non vide. 

Si la valeur de I'attribut test est egale a true, le modele de transformation associe est 
instancie ; si non, il ne Test pas. 

II n'y a pas de else possible, al I ant de pair avec le xsi :if ; si I'on veut une alternative a 
deux branches, il faut utiliser instruction xsi :choose. 

Exemple 

N ous reprenons notre fichier XML d'annonce de concert : 
Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</I_ieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 



<Concert> 
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<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Composi teur>M. Marais</Composi teur> 

<Composi teur>D. Castel 1 o</Compositeur> 

<Composi teur>F. Rognoni</Composi teur> 
</Compositeurs> 

</Concert> 

Comme dans le tout premier exemple vu, (voir figure 3-1), nous cherchons a en faire une 
page HTM L, avec les compositeurs presentes sous la forme d'une liste de noms separes 
par une virgule. 

M ais la difficult^ est ici que les virgules ne sont pas fournies dans le texte du fichier 
XML. C'estdonc la feui He de style X SL qui va devoiren inserer uneapres chaque nom, 
sauf apres I e dernier (d'oii I' intervention d'une instruction xsi : if pour tester cette condi- 
tion). 

Comment exprimer la condition ? II faut constituer un node-set contenant les Composi- 
teur^, sachant que le dernier repondra au test positionc ) = lasto. 

Voyons ce que cela donne si nous ecrivons une regie dont le motif Concorde avec 

<Compositeur> : 

<xsl :template match="Compositeur"> 

</xsl :templ ate> 

Supposons que le nceud courant soit par exemple le <compositeur> D. Castello, et que 

I 'algorithme de recherche de concordance se lance ; il va determiner que le motif de cette 
regie Concorde avec le nceud courant, parce qu'en prenant le nceud parent <composi- 
teurs> comme nceud contexte, et en evaluant I'expression XPath "child: : compo- 
siteur", on obtient un node-set de trois elements <compositeur>, qui contient le nceud 
courant. Dans ce node-set, le nceud courant a la position 2, le test position ) = lasto 
devrait done repondre false. 

II semble done que cela devrait pouvoir marcher ; neanmoins si on essaye, on constate 
quecen'est pas lecas. En cherchant un peu, on finit par determiner que les trois elements 
<Compositeur> n'ont pas comme position (dans le node-set dont i I estquestion ci-dessus) 
1, 2, et 3, mais 2, 4, 6. C'est du a ce que I 'element <compositeurs> n'a pas trois enfants 
directs, mais sept : 

• un premier enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne ; 

• un deuxieme enfant de type element, <Compositeur>M. Marais</Compositeur> ; 
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• un troisieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne ; 

• Un quatrieme enfant de type element, <Compositeur>D. Castello</Compositeur> ; 

• un cinquieme enfant de type text ne contenant que des espaces, tabulations ou finsde 
ligne ; 

• Un Sixieme enfant de type element, <Compositeur>F. Rognoni</Compositeur> ; 

• un septieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne. 

Note 

Revoir a ce sujet la section Exemple d'arbre XML d'un document, page 38. 

La solution, pour retablir unenumerotation plus conforme a I 'intuition, est bien sur d'eli- 
miner ces nceuds « parasites » de type texto, ce que I'on fait grace a instruction 

<xsl :strip-space element="Compos"iteurs"> . 

On aboutit alors a la feuille de style suivante : 
Concert.xsl 

] <?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='htinl ' encodings' ISO-8859-1 ' /> 

<xsl :strip-space elements='Compositeurs'/> 

<xsl :templ ate match="/"> 
<html> 
<head> 

<title><xsl :value-of sel ect="/Concert/Entete"/X/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl :template match="Entete"> 

<p> <xsl :value-of select="."/> presentent </p> 
</xsl :templ ate> 

<xsl :templ ate match="Date"> 

<H1 al ign="center"> Concert du <xsl :val ue-of select="."/> </Hl> 
</xsl :template> 



<xsl :templ ate match="Lieu"> 
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<H4 align="center"> <xsl :value-of select=" . "/> </H4> 
</xsl :templ ate> 

<xsl :template match="Ensembl e"> 

<H2 align="center"> Ensemble <xsl :value-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl : apply-templ ates/> </H3> 
</xsl :templ ate> 

<xsl :template match="Compositeur"> 
<xsl :val ue-of sel ect=" . "/> 

<xsl:if test="not(position( ) = last())">, </xsl:if> 
</xsl :templ ate> 



<xsl :templ ate match="text()"/> 



</xsl :stylesheet> 

Le modele de transformation associe a ^instruction xsi :if n'est instancie que pour les 
elements dont la position (dans le node-set calcule lors de la recherche de concordance) 
n'est pas la derniere. 

Remarquons aussi la derniere regie, vide, qui remplace la regie par defaut s'appliquant 
aux textes, ceci afin d'eviter la presence dans le resultat des nceuds ignores par cette 
feuillede style, notamment <Nom> et <instrument>. 

Le resultat obtenu est lesuivant (voir aussi la figure 5-1) : 

Concert .html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d’Anacréon </title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<p> Les Concerts d’Anacréon présentent </p> 
<H1 align="center"> Concert du Jeudi 17 janvier 2002, 20H30</H1> 
<H4 align="center">Chapelle des Ursules</H4> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
<H3 al ign="center"> Oeuvres de <br>M. Marais, D. Castello, F. Rognoni 
</H3> 
</body> 
</html> 

Terminons en indiquant qu'il n'etait peut-etre pas necessaire de trier les elements pour 
lesquels on elimine les enfants detype texto ne contenant que des espaces blancs (i.e. 
un espace, une tabulation, un retour ligne ou un saut de ligne). Si I'on veut elaguer par- 
tout, On eCrira plutot : <xsl :strip-space element="*">. 
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Figure 5-1 
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<xsl :choose> 



<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
select=" Interpreted] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwi se> 



</xsl :choose> 



Instruction xshchoose H 
Chapitre 5 | 

Cet exemple montre une instanciation conditionnelle de plusieurs fragments de modeles 
de transformation. Le but est d'obtenir trois formes possibles d'enumeration, suivant le 
nombre d'elements a enumerer : 

• xxx : dans le cas ou il n'y a qu'un seul element ; 

• xxx et xxx : dans I e cas oii i I y a deux el ements ; 

• xxx, xxx, xxx : dans le cas oil il n'y a plus de deux elements. 

Syntaxe 

xsl :choose 

<xsl :choose> 

<!-- autant de xsl:when que l'on veut, mais au moins 1 en tout --> 

<xsl :when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 

<xsl :when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 



<!-- 1 'element xsl :otherwise est facultatif --> 
<xsl :otherwise> 

<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :otherwise> 

</xsl :choose> 

L'instruction xsi :choose nedoit pas apparaitre en tant qu'instruction de premier niveau. 

Regie XSLT typique 

UneregleXSLT uti I isant ^instruction xsi :choose sera souvent employee commececi : 

<xsl :template match="... motif (pattern) ..."> 
<xsl :choose> 
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<xsl :when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 

<xsl :otherwise> 

<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :otherwise> 

</xsl :choose> 
</xsl :templ ate> 

C'est I'equivalent du if avec sesdeux branches then etelse. 
Semantique 

C'est une instruction qui instancieau plus un modele de transformation. Les expressions 
XPath des differents elements xsi :wnen sont evaluees en sequence; des que I 'une est 
vraie, le modele de transformation associe est instance ; si aucune n'est vraie, et si un 
element xsi : otherwise est present, son modele de transformation associe est instancie. 
Si aucune n'est vraie, ets'il n'y a pasd'elementxsi :otherwise, aucun modele de trans- 
formation n'est instancie. 

II n'est done pas necessaire que les conditions exprimees soient mutuellement exclu- 
sives : memesi plusieurs sontvraies, seulela premiere d'entre el les entralnera I'instan- 
ciation du modele associe. 

Exemple 

ProgrammeConcert.xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 

<ProgrammeConcert> 
<PageTitre> 

<Entete> 

"Les Concerts d'Anacreon" 

<Date>Samedi 9 octobre 1999, 20H30</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
</Entete> 



<Ensembl e> 
<Nom> 

La Cetra d'Orfeo 
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</Nom> 

<Di recti on> 

Michel Keustermans 
</Di recti on> 
</Ensembl e> 

<Interpretes> 
<Role> 
tenor 

<Interprete> Yvan Goossens </Interprete> 
</Role> 
<Role> 

basse 

<Interprete> Conor Biggs </Interprete> 
</Role> 
<Role> 

flute a bee 

<Interprete> Michel Keustermans </Interprete> 

<Interprete> Laura Pok </Interprete> 
</Role> 
<Role> 

viole d'amour 

<Interprete> Vinciane Baudhuin </Interprete> 
</Role> 
<Role> 

oboe da caccia 

<Interprete> Blai Justo </Interprete> 
</Role> 
<Role> 

viole de gambe 

<Interprete> Rika Murata </Interprete> 

<Interprete> Martin Bauer </Interprete> 

<Interprete> Sophie Watillon </Interprete> 
</Role> 
<Role> 

violone 

<Interprete> Benoit vanden Bemden </Interprete> 
</Role> 
<Role> 

orgue positif et clavecin 
<Interprete> Jacques Willemijns </Interprete> 
</Role> 
</Interpretes> 

<TitreConcert> 

Cantates allemandes 
</TitreConcert> 

<Compositeurs> 

<Compositeur> Bach </Compositeur> 
<Compositeur> Telemann </Compositeur> 
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</Compositeurs> 



</PageTitre> 



</ProgramirieConcert> 

Nous supposons ici que nous voulons sortir uniquement les noms des musiciens, classes 
par instruments ; de plus, s'il y a deux musiciens pour un instrument donne, les noms 
seront separes par « et», mais s'il y en a trois ou plus, ils sortiront separes par des vir- 
gules. 

II est done necessaire, ici, de compter le nombre d'elements d'un node-set : cela se fait 
tres bien grace a la fonction XPath count( ). 

Voici une premiere version de la feuille de style : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding='IS0-8859-l' /> 



<xsl : tempi ate match="Role"> 



<xsl :value-of select=" . /chi Id: : text( )"/> : 
<xsl :choose> 



<xsl:when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select=" Interpreted] "/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 



<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 
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Pour un element <Roie> donne, on commence par ecrirelenom del 'instrument, recupere 
en tant que valeur du nceud de type text, enfant direct du <Roie> courant. Ensuite, le 
<xsi :choose> permet de discriminer trois cas possibles : un seul interprets ou deux, ou 
plus (xsi : otherwise correspond a trois ou plus, parcequ'il n'y a jamais aucun interpreted 

On remarquera I'utilisation de I'expression XPath interpreted] , qui est la forme 

COUrtede child: : Interprete[positior,( ) = 1] . 

Voici cequ'on obtient : 
Resultat 

flute a bee 

Michel Keustermans et Laura Pok 
viole d'amour 

Vinciane Baudhuin 

oboe da caccia 

Blai Justo 

viole de gambe 

Rika Murata , Martin Bauer , Sophie Watillon 
violone 

Benoit vanden Bemden 

orgue positif et clavecin 

Jacques Willemijns 

II y a clairement un problemede repartition des espaces blancs, maiscetypedeprobleme 
survi ent necessai rement des que I 'on declare une sortie en mode text, comme dans I e cas 
present. 

Le moment n'est pas encore venu d'etudier d'une facon generale les problemes d'es- 
paces blancs en XSLT, nous verrons cela dans le chapitre consacre a instruction 
xsittext (voir Instruction xsl : text, page 250), ou nous continuerons I'etude de cet 
exemple afin de rendre le resultat presentable. 



Instruction xshvariable 

Une variable, en XSLT comme dans tout autre langage, est I'association d'un nom et 
d'une valeur. Neanmoins, en XSLT, cette association est indestructible : il est impossible 
de changer la valeur d'une variable, une fois qu'on I'a determined. Nous I'avons deja 
signale plusieursfois, maisil estimportantde rappelerici que le langage XSLT estun lan- 
gage fonctionnel pur (mais pas complet, dans la mesure ou il ne permet pas de manipuler 
les fonctions comme des donnees), done sans affectation ni effet de bord. En particu- 
lier, les fonctions (qu'elles soient predefinies ou definies explicitement sous forme de 
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model es nommes) sont des fonctions qui ne modifient en aucune facon I'etat du proces- 
sus XSLT. 

En XSLT, il est interdit de declarer plusieurs fois la meme variable (il en est de meme 
dans la plupart des langages), et la seule instruction permettant d'affecter une valeur 
a une variable n'est autre que sa declaration ; la conclusion tombe d'elle-meme : les 
variables ne peuvent pas changer de valeur. 

L'instruction xsi variable decrite dans cette section est precisement eel le qui combine 
declaration et initialisation. 



Bande-annonce 

<xsl :variable name="nombreInterpretes" sel ect="count( . /Interprete) " /> 
<xsl :choose> 

<xsl :when test="$nombreInterpretes = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="$nombreInterpretes = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
sel ect=" Interpreted] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

Cet exemple montre ^initialisation d'une variable (nombreinterpretes), et son utilisa- 
tion par appel de Sa Valeur ($nombreInterpretes). 

Une variable peut aussi etre initial i see par instanciation d'un model e de transformation 
litteral, comme ceci : 

<xsl :variable name="maison"> 
<RDC> 

<cuisine surface='12in2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande baie vitree. 
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</sejour> 

<bureau surface='15m2'> 

Bibliotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 

Le model ede transformation peuttres bien etre calcule (etdonc nepas etre entierement 
literal) : 

<xsl :variable name="mouveinent"> 
<insert> 

<Ensembl e> 

<NomXxsl :value-of select="NomEnsemble"/X/Nom> 

<Di recti onXxsl : val ue-of sel ect="Chef VX/Di recti on> 

</Ensembl e> 

<Concert> 

<DateXxsl :value-of sel ect="Date"/X/Date> 
<VilleXxsl :value-of select="Ville"/X/Vi11e> 
<LieuXxsl :value-of select="Salle"/X/Lieu> 
<Ti treXxsl : val ue-of sel ect="TitreConcert"/X/Titre> 
</Concert> 
</insert> 
</xsl :variable> 

Syntaxe 

xsl :variable 

<xsl :variable name="..." select=" ... expression XPath ... "/> 

Autre possibilite : 

xsl :variable 

<xsl :variable name="..."> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :variable> 

instruction xsi : variable peut aussi apparaltre comme instruction de premier niveau. 

Regie XSLT typique 

Typiquement, les instructions xsi:variabie seront reparties a volonte dans le pro- 
gramme XSLT comme ceci : 
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<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='...' encodings ISO-8859-1 ' /> 

<xsl rvariable name='...' select='...' /> 

<xsl : tempi ate match="..."> 

<xsl :variable name='...'> 

</xsl :variable> 

</xsl :templ ate> 

<xsl rvariable name='...'> 

</xsl :variable> 

<xsl : tempi ate match="..."> 

<xsl :variable name='...' select^'...' /> 

</xsl :templ ate> 

</xsl :stylesheet> 

En effet, une instruction xsi : variable peut apparaitre a peu pres n'importe ou dans un 
programme XSLT ; on peut meme la trouver comme enfant direct de I 'element racine 
<xsi :styiesneet> (dans ce cas, c'est une instruction de premier niveau). Cela ne veut 
pas dire qu'une variable est necessairement visible (ou utilisable) partout; il y a des 
regies de visibility, comme en C ou Java (voir Regies de visibility page 212). 



Semantique 

En tant qu' instruction XSLT, I 'instruction xsi : variable peut apparaitre dans un model e 
de transformation associe a une regie (voir ci-dessus, Regie XSLT typique, page 181), ce 
qui fait qu'il y a en general deux model es de transformation a distinguer : un propre a la 
variable elle-meme, et un propre a la regie XSLT considered : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl :templ ate match="..."> 

<!-- modele de transformation propre a la regie --> 

<xsl :variable name='...'> 

<!-- modele de transformation propre a la variable --> 



<!-- fin du modele de transformation propre a la variable --> 
</xsl :variable> 
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<!-- fin du modele de transformation propre a la regie --> 
</xsl :templ ate> 

</xsl :stylesheet> 

Lorsque le modele de transformation de la regie est instance, I 'instruction <xsi :varia- 
bie>. . .</xsi :variabie> ou <xsi :variabie . . ./> est remplacee par ri en (c'est-a-dire 
est supprimee : rien est la valeur de remplacement). Cela ne veut pas dire qu'elle est 
ignoree ; cela veut seulement dire que sa contribution au texte produit dans le fragment 
deresultat, lors de cette instanciation, est n u 1 1 e : levrai travail sefaiten coulisse. 

En effet, la semantique de devaluation de I 'instruction xsi variable est eel le de I'atta- 
chement d'une valeur a un nom. La valeur est elle-meme I'association d'une donnee et 
d'un type qui permet d'interpreter la donnee. Par exemple la donnee 387 sera interpreted 
comme la valeur true si le type est booleen, comme la valeur numerique387 si le type est 
Number, et comme la suite de caracteres 3,8,7 si le type est String. La variable prend 
dynamiquement son type d'apres celui de la valeur recue : il n'y a pas de typage statique 
comme en C ou Java. 

L a valeur peut etre obtenue de deux manieres : 

• soit e'est le resultat de I 'evaluation d'une expression XPath fournieen tant qu'attribut 
select. Rappelons (voir XPath, un langage d 'expressions, page 40) qu'il y a quatre 
types de valeurs possibles pour une telle expression : String, Number, Boolean, et 
Node- set. 

Dans ce cas, I 'element <xsi : variable name=" ..." seiect=" ..."/> doit Stre vide (si 
la balise defermeture <xsi : variable . . .> est presente, il ne doit rien y avoir d'autre 
que d'eventuels espaces blancs entre <xsi :variabie . . .> et </xsi :variabie>). 

• soit e'est un arbre XML, resultat de I'instanciation du modele de transformation 

propre a instruction <xsl variable name= "...">. 

Dans ce cas, I ' attri but sei ect=" . . . ° ne doit pas etre fourni. 

U n tel arbreX M L s'appelle un TST (Temporary SourceTree), et le type de la variable 
est alors soit node-set en XSLT 1.1 ou plus, soit RTF (Result Tree Fragment) en 
XSLT 1.0. 

R appel ons que cette i nstanci ation se produit I ors de I ' i nstanci ati on du model e de trans- 
formation dans lequel la variable est immergee, si e'est une variable locale ; si e'est 
une variable globale, I'instanciation se produit justeavant la premiere etape (voir Trai- 
tementdu document XM L source, page 87) du modele detraitement. 

La premiere possibility nepose pas de probl erne parti culier : avec les expressions XPath, 
on est en terrain connu. Par contre, avec la deuxieme, nous voici confronted a une notion 
nouvelle : qu'est-ce qu'un Temporary SourceTree, et que peut-on en faire? 

Avant de repondre a ces questions, nous al Ions d'abord voir quelques exemples d' utilisa- 
tion d'une variable dont la valeur provient d'une expression X Path. 
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Variables globales et locales 

Comme beaucoup d'autres langages de programmation, XSLT fait la difference entre 
variable globale et variable locale. Une variable locale est une variable definie a I'inte- 
rieur d'un modele de transformation, alors qu'une variable globale est une variable 
definie a I'exterieur d'une regie XSLT, en tant qu'element XM L enfant direct de I'ele- 

ment <xsl : styl esheet>. 

En regie general e, dans les langages traditionnels, les variables globales n'ont pas bonne 
reputation ; on recommandetoujoursd'en eviter I 'usage, car el le rendent plus diffici I es I a 
maintenance et la comprehension des programmes. C'est du a une raison tres simple : 
une variable globale peut etre affectee depuis n'importe quel endroitdu programme, ren- 
dant ainsi tres complexes les relations et les roles qui s'etabl issent entre les differentes 
parties du programme qui mettentajour cette variable. 

En XSLT, plus rien de toutca, puisque les variables nesont pas modifiables : il n'y a pas 
d' inconvenient parti culier a declarer des variables globales. 

Utilisation d'une variable 

Referencer une variable de nom x, c'est obtenir la valeur attachee au nom x ; cela se fait 
en ecrivant $x. 

Note 

L'expression $x peut etre vue comme I'application de I'operateur $ au nom x, renvoyant la valeur de x. Toutefois, 
cette interpretation s'eloigne de la grammaire XSLT, car$n'estpas un operateur, etdans I'ecriture $x, un espace 
n'estpas autorise entre le Set lex. 

Dans une expression XPath 

U ne reference de variable peut apparaitre dans une expression X Path, partout ou apparait 
une so us- expression renvoyant I'un des types de base en XPath, c'est-a-dire Number, 
String, Boolean, et Node-set. 

Leseul problemequel'on puisse rencontrer pour mettreen pratique cette affirmation, est 
celui du decoupage d'une expression en sous-expressions. 

Plus precisement, si I'on construit une expression qui ne manipule que des Number, 
String ou Boolean, il n'y a aucun probleme : on est dans une situation familiere, iden- 
tique a eel I e des autres langages courants. On peut utiliser une variable la ou intuiti- 
vement, on en utiliserait une dans un langage comme C ou J ava : 

... select="string-length( concat( $before, $after ) ) - SnbSepar" ... 

Les difficultes surviennent avec les expressions renvoyant un node-set : ces expressions 
sont construites a base de chemins de localisation, et la question qui se pose est de savoir si 
un chemin de localisation est une expression qui peut se decomposer en so us- expressions. 
Si oui, chaque so us- expression peut alors etre remplacee par une reference de variable 
renvoyant la meme valeur. 
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1 1 y a deja un premier element de reponse assez evident : chaque predicat est une expres- 
sion booleenne, elle-meme decomposable en sous-expressions : toutes ces expressions 
sont remplacables par une reference de variable. 

En dehors des predicats, il n'y a qu'un seul element, dans un chemin de localisation, qui 
peut etre remplace par une valeur, c'est I 'amorce, qui fournit le node-set des nceuds- 
contexte (voir Chemins de localisation, page 62). L'expression ci-dessous est done syn- 
taxiquementcorrecte : 

$amorce/chi Id: : Interprete/child: :Nom 

et pour qu'elle soit semantiquement correcte, il suffit que la variable amorce soit du type 
node-set, autrement dit que la reference a cette variable renvoie un node-set. 

Ailleurs (en dehors des predicats), il est impossible de faire figurer une reference de 
variable, car une etape de localisation n'est pas une expression, un axe de localisation 
n'est pas une expression, un determinant n'est pas une expression. 

Tout processeur XSLT doit done refuser (des la decouverte du caractere '$') les expres- 
sions suivantes : 

/$nomAxe: : Interprete/child: :Nom <!-- faux ! --> 
/child: :$nomElement/child: :Nom <!-- faux ! --> 

Dans un motif 

Une reference de variable ne peut jamais intervenir dans un motif, e'est-a-dire dans 
l'expression XPath fournie en tant que valeur de I'attribut match de instruction 
xsi template (I 'instruction xsi : key utilise aussi un motif, de meme que instruction 
xsi : number ; ce sont les trois seuls endroits d'un programme XSLT ou un motif peut 
intervenir, et dans ces trois cas, une reference de variable est interdite). 

La raison estquecela pourrait introduire une circularite entre la definition de variable et 
devaluation du motif ; on verra cela plus en detail a la section Regies de visibility pour 
les variables globales, page212. 

Exemple d'utilisation d'une variable 

Reprenons le programme XSLT vu pour instruction xsi:choose (voir Exemple, 
page 176). 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl : tempi ate match="Rol e"> 

*<xsl : val ue-of select="normalize-space( ./child: :text( ))"/> : 
<xsl :choose> 
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<xsl:when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select=" Interpreted] "/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 



<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 

N ous pourrions reecri re ce programme comme ceci : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encoding='IS0-8859-l' /> 



<xsl : tempi ate match="Role"> 



*<xsl :value-of select="normalize-space( ./child: :text())"/> : 

<xsl :vari abl e name="nombreInterpretes" sel ect="count( . /Interprete) " /> 

<xsl :choose> 



<xsl :when test="$nombreInterpretes = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl :when test="$nombreInterpretes = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
sel ect=" Interpreted] "/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) = 
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last())">, </xsl :if> 

</xsl : for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

La variable nombrelnterpretes est une variable locale, qui n'apporte pas grand-chose au 
programme, il estvrai, etantdonne sa simplicity. M aison entrevoittoutdememel'interet 
qu'il peut y avoir a utiliser une variable au lieu d'une valeur dans une expression : c'est 
d'apporter un confort de lecture appreciable, notamment quand I'expression qui lui a 
donne sa valeur est compl iquee, et que le nom de la variable est suffisamment semantique 
pour eclairer la signification de I'expression en question (il faut ici se rappeler que ce qui 
coute cher, ce n'est pas d'ecrire un programme, mais de le maintenir ; or le maintenir, 
c'est constamment le relire ; c'est pourquoi il est preferable d'opti miser la faci lite de lec- 
ture d'un programme, qued'en optimiser la facilite d'ecriture). 

II y a par contre un casou une variable est necessai re, c'est eel ui ou on veut manipuler un 
TST, puisque par definition, I'existence d'un TST implique eel le d'un modele de trans- 
formation associe a une variable. 

Evaluation d'une variable globale 

La declaration d'une variable necessite en general devaluation d'au moins une expres- 
sion X Path, contenue dans I 'attribut sei ect de la declaration, ou contenue dans le modele 
de transformation associe a la variable si sa valeur est un TST. Or, on sait qu'uneexpres- 
sionXPath ne peut generalement pas etreevalueedans I'absolu : il fautun nceud contexte 
et une liste contexte (pour une variable locale, il n'y a pas de probleme, puisqu'elle est 
declaree dans un modele de transformation, qui est toujours instancie relativement a un 
nceud contexte et une liste contexte). 

La regie est done qu'une variable globale est evaluee relativement a un nceud contexte 
qui est le nceud racinede I'arbreX M L du document, et avec une liste contexte qui est la 
liste ne contenant que ce nceud. 

Exemple 

Dans cetexemple, on dispose d'un extraitXM Lise d'une base dedonnees produits (cata- 
logue) : 

BaseProduits.xml 

<?xml version="1.0" encoding="UCS-2" standal one="yes"?> 
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<BaseProduits> 
<LesProduits> 

<Livre ref="vernesl" NoISBN="193335" gamme^roman" media="papier"> 
<refOeuvre> 

<Ref valeur="200001slm"/> 
</refOeuvre> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boileaunarcejacl" NoISBN="533791" gamme="roman" medi a="papier"> 
<refOeuvre> 

<Ref valeur="liatlc.bn"/> 
</refOeuvre> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 

<Enregistrement ref="marai si" Ref Editeur="LC000280" 

gamme="violedegaiTibe" media="CD"> 

... sans interet pour l'exemple 
</Enregistrement> 

<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamme="l ecteurCD" 

marque="HarKar"> 

... sans interet pour l'exemple 
</Materiel> 

<Livre ref="phbeaussantl" NoISBN=" 138301 " gamme="essai " medi a="papier"> 
<refOeuvre> 

<Ref valeur="vadb.phb"/> 
</refOeuvre> 

<Prix valeur="60" monnaie="FF"/> 
<Prix valeur="8" monnaie="£"/> 
</Livre> 

</LesProduits> 

<LesOeuvres> 

<0euvre ref="200001 slm"> 

<Titre> Vingt mille lieues sous les mers </Titre> 
<refAuteurs> 

<Ref val eur="JVernes"/> 
</refAuteurs> 
</0euvre> 

<0euvre ref="marais.folies"> 

<Titre> Les Folies d'Espagne </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
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</refAuteurs> 
</0euvre> 

<0euvre ref="vadb.phb"> 

<Titre> Vous avez dit baroque ? </Titre> 

<refAuteurs> 

<Ref val eur="PhBeaussant"/> 

</refAuteurs> 
</0euvre> 

<0euvre ref="marais .piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 

<refAuteurs> 

<Ref valeur="MMarais"/> 

</refAuteurs> 
</0euvre> 

<0euvre ref="liatlc.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref val eur="ThNarcejac"/> 
</refAuteurs> 
</0euvre> 
</LesOeuvres> 

<!-- ... suite du fichier sans interet pour l'exemple ... --> 
</BaseProduits> 

En supposant que I'etat du catalogue est fourni par les elements contenus dans I 'element 
<LesProduits>, on veut obtenir la liste des titres d'ceuvres correspondant a un livre au 
catalogue. 

Pour chaque <oeuvre>, on va done rechercher si celle-ci correspond a un livre ; si oui, on 
sort letitre de I'ceuvre. 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl :variable name="l i vresAuCatal ogue" 

select="/BaseProduits/LesProdui ts/Li vre"/> 

<xsl : tempi ate match="Oeuvre"> 

<xsl :variable name="oeuvreCourante" select="."/> 

<xsl :for-each select="$livresAuCatalogue"> 

<xsl:if test="$oeuvreCourante/@ref = ./refOeuvre/Ref/@valeur"> 

- <xsl :value-of select="$oeuvreCourante/Titre"/> 
</xsl :if> 
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</xsl :for-each> 
</xsl :templ ate> 

<xsl :templ ate match="text( ) "/> 
</xsl :stylesheet> 

Pour ce faire, on declare une variable globale livresAuCataiogue dont la valeur est un 
node-set contenanttous les elements <i_ivre> del'element <i_esProduits>. Cette variable 
n'est pas absolument indispensable, car il aurait ete possible d'ecrire I'expression 

XPath /BaseProduits/LesProduits/Livre directement COmme Valeur d'attri but select 

del'instruction xsi :for-each. Neanmoins, c'est plus cl air, car plus prochedela semanti- 
que metier, de parler de livre au catalogue, quede /BaseProduits/LesProduits/Livre. 

La variable nvresAuCataiogue est une variable globale, done le calcul de sa valeur se 
fait en prenant la racine de I'arbre XM L du document comme nceud contexte. M ais ici, 
I'expression XPath a calculer est un chemin absolu, ce qui rend inutile la connaissance 
du nceud contexte. II aurait toutefois ete possible et equivalent d'ecrire : 

<xsl :variable name="livresAuCatalogue" select="BaseProduits/LesProduits/Livre"/> 

Cela aurait donne le meme resultat, etant donne le nceud contexte utilise. 

Ceci etant, la suite du programme montre un exemple d'emploi de variable (locale, cette 
fois-ci), dontil serait plus difficile dese passer. En effet, la variable oeuvreCourante per- 
met de garder au chaud le nceud courant, sachant qu'on va bientot le perdre, a cause de 
instruction xsi :for-eacn. Dans le modele d'instanciation du xsi :for-each, le nceud 
courant parcourt I'ensemble des livres au catalogue; on n'a done plus la possibility de 
connaitre I'ceuvre en cours, a moins de I'avoir sauvegardee dans une variable. C'est ce 
qui est fait ici. 

Lecriterede sortie d'un titre est que I 'attri but ref de I'ceuvrecourantesoitegal a I'attri- 
but valeur de la Ref de la refOeuvre du livre au catalogue courant. 

Etvoici le resultat obtenu : 



II aurait ete possible de prendre le probleme a I'envers : e'est-a-dire d'ecrire une regie 
pour les <Livre>, et d'aller chercher I'ceuvre correspondante : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 




Resultat 



- Vingt mille lieues sous les mers 

- Vous avez dit baroque ? 

- L'ingenieur aimait trop les chiffres 



<xsl:output method='text' encoding='IS0-8859-l' /> 
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<xsl :variable name="l esOeuvres" select="BaseProduits/Les0euvres/0euvre"/> 

<xsl : tempi ate match="Livre"> 

<xsl : variabl e name=" reference" sel ect=" . /refOeuvre/Ref /@val eur"/> 
- <xsl :value-of 

sel ect="$l esOeuvres /Tit re [ 
parent: :0euvre[ 

Oref = $reference 

] 

]"/> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Remarque 

La section qui suit est a rapprocher de la remarque Noeud courant - Nceud contexte, page 89, qui anticipaitsur 
ce qui est explique maintenant, en montrant qu'il y a lieu de distinguer nceud courant et nceud contexte, meme 
s'ils sontsouvent confondus. 

Le programme est un peu plus simple (pas de xsi : for-each, ni de xsi :if), par contre 
I'une des expressions X Path uti I i sees est nettement plus compliquee. 

La encore, deux variables sont uti I i sees, mais aucune n'est reellement necessaire. La 
variabl e globale pourrait etre faci I ementsupprimee ; la variable locale un peu moinsfaci- 
lement. Pourquoi ? Remarquons d'abord que des <oeuvre> qui sont des parents de 
<Titre>, il n'y en a pas qu'une ; done le processeur XSLT est bien oblige de faire une 
boucleen interne pour rechercher celle qui correspond au criteresur I es references. Cette 
boucle fait evol uer I e nceud contexte, qui va tour a tour designer chacune des ceuvres pos- 
sibles ; et pour chacuned' ell es, I e predicat [ @ref = $reference ] sera evalue, avec une 
valeur de @ref differente a chaque fois. 

Si Ton veut se passer de la variable locale reference, il faut done ecrire quelque chose du 
genre : 

parent: :0euvre[ @ref = . /refOeuvre/Ref /@val eur ] <!-- faux !! --> 

L'intention est correcte, mais cela ne marche pas, parce que le « . » dans ./refoeuvre/ 
Ref/@vaieur designe le nceud contexte (e'est-a-dire self: :nodeo, en notation longue). 
Or, precisement, commeon vient de le voir, le nceud contexte n'est pas stable dans deva- 
luation du predicat. II faut reellement pouvoir recuperer ici le nceud courant, et pour cela, 
il n'y a que deux solutions : soit utiliser une variable (deja vu), soit utiliser la fonction 
predefinie current( ), qui, comme son nom I'indique, renvoie le nceud courant. 

On pourrait done se passer de variable en ecrivant la regie ainsi : 



<xsl :template match="l_ivre"> 
- <xsl :value-of 
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sel ect="/BaseProdui ts/LesOeuv res /Oeuv re/Tit re[ 
parent: :0euvre[ 

@ref = current( )/refOeuvre/Ref /@val eur 

] 

]"/> 
</xsl :templ ate> 

Personnel I em ent, je prefere la version avec variable, parce qu'elle me semble plus claire 
etpluslisible. 



Temporary Source Tree 

Un Temporary Source Tree (ou TST) est I'arbreXM L qui resulte de I'instanciation d'un 
modele de transformation. 

Lorsque ce modele de transformation est associe a une instruction <xsi :variat>ie>, le 
TST represente alors la valeur de cette variable, et c'est done la valeur renvoyee comme 
resultat lorsqu'on reference la variable. 

Remarque 

C'estici qu'il y a une divergence assez profonde entre XSLT 1.0 etXSLT 1.1 



Plus precisement, cequi est renvoye comme resultat, en XSLT 1.1 ou plus, c'est un node- 
set ne contenant qu'un seul element, a savoir la racine de I'arbre ainsi construit. 

Done, lorsqu'une telle variable est instanciee (en X SLT 1.1 ou plus), il y aalorsau moins 
deux sources XM L pour le programme XSLT : la premiere, qui existedetoutefacon tou- 
jours, est I'arbre XML construit d'apres le document source a traiter ; la deuxieme est 
I'arbreXML qui resulte de I 'instanciation de la variable en question. 



Note 

Parcontre, en XSLT 1.0, la valeur d'une variable contenant un TST n'estpas de type node-set, mais d'un type 
special, Result Tree Fragment (RTF), propre a XSLT 1.0, etqui a disparu en XSLT 1.1 (voir Result Tree Fragment 
(XSLT 1.0), page 208). Le fait que ce ne soit pas un node-set interdit Implication d'expressions XPath au TST 
obtenu en referencantla variable. LeTST, en XSLT 1.0, n'estdonc pas une source XML a part entiere. 
En XSLT 1.1 ou plus, au contraire, I'arbre XML construit d'apres le document source a traiter, et le TST qui 
resulte de I'instanciation d'une variable contenant un modele de transformation sont traites a egalite de nature, 
notamment en ce qui concerne la possibility de leur appliquer des expressions XPath, TST est bien sur une 
denomination qui convient pour le futur de XSLT tel qu'on peut le comprendre au travers du Working Draft 
XSLT 1.1 ou du Working Draft XSLT 2.0, mais il faut savoir que ce n'estpas du tout une denomination officielle 
duW3C. 

Temporary Tree est une nouvelle denomination, initialement proposee par Michael Kay dans la deuxieme edition 
de son ouvrage de reference sur XSLT (parue apres la publication du Working Draft XSLT 1.1), que j'ai legere- 
ment modifiee en Temporary Source Tree, pour mettre en evidence la notion de source, qui me semble ici tres 
importante. Le qualificatif de « temporaire » associe a unTST vientde ce qu'un TST n'a d'existence que durant 
I'execution, etque cette existence est limitee a celle de la variable a laquelle il estaccroche. 
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Si Michael Kay a ete oblige d'inventerun nouveau terme, c'estparce que le Working Draft XSLT 1.1 n'en propo- 
sal tout simplement pas. Pourles besoins des explications, Michael Kay a du trouverun nom pour designer un 
arbre constituantla valeurd'une variable, etil a choisi Temporary Tree. P lus tard, Michael Kay estdevenu redac- 
teurde publication de la recommandation W3C pour XSLT 2.0, etle premier Working Draft (20 decembre 2001) 
a introduit la notion de Temporary Tree. 

Personnellement, j'aurais prefere parlerde Primary Source Tree, pour designer I'arbre source provenantdu docu- 
ment source a traiter, et de Secondary Source Trees, pour parler des arbres lies aux variables du programme. 
Neanmoins, comme I'ouvrage de Michael Kay estune reference, etque le Working Group XSL du W3C semble 
lui emboiter le pas, il me semble preferable de ne pas trap m'ecarterde sa proposition, afin de ne pas derouter 
les lecteurs avec une denomination exotique. 

II y a plusieurs vari antes deTST, qui sol I i ci tent plus ou moins le moteur XSLT, mais ces 
variantes ne dependent pas de la version (1.0 ou 1.1 et plus) de XSLT considered. En 
effet, tant qu'on ne cherche pas a utiliser un TST, mais seulement a le construire, il n'y a 
aucune difference entre X SLT 1.0 et X SLT 1.1. C 'est ce qui etait rageant en X SLT 1.0 : 
on pouvait construire des TST tant qu'on voulait, mais il n'y avait pratiquement rien 
d'interessant pour les manipuler unefois construits. Les variantes que nous allons main- 
tenant voi r sont des vari antes de construed on, et non des vari antes d' uti I i sati on. 

TST obtenu litteralement 

La variante la plus simple, et qui sollicite le moins le moteur XSLT, est eel le qui ne 
contient aucun element du domaine nominal "xsi : ; le TST est obtenu a partir d'un 
model ede transformation litteral, qui ne contient done aucun element calcule. 

Exemple : 

<xsl :variable name="mai son"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 

Bibl iotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 



Les instructions de programmation 

Chapitre 5 



Cette variable est done liee a un TST construit a partir d'un fragment de document XM L 
parfaitement correct, e'est-a-dire bien forme : un seul element racine, et structure d'arbre 
respectee. 

LeTST en question esttoutsimplementl'arbreXML resultant (voir figure 5-2). 



root 



Note : les noeuds text ne 
contenant que des espaces 
blancs ne sont pas montres. 





text 

Evier inox. 
Mobilier 
encastre. 





Lavabo. 




Cumulus 




200L 



text 

Cheminee en 
pierre. 
Poutres au 
plafond. 
Carrelage terre 
cuite. 
Grande baie 
vitree 



text — 

Bibliotheque 
encastree. 



text 

Palmier en zinc 
figurant le 
desert 



Figure 5-2 

Temporary Source Tree attache a la variable « maison 



Note 

Les nceuds de type fexfne contenant que des espaces blancs ne sont pas montres, afin de ne pas surchargerla 
figure ; pour voir ce que cela donne quand on en tient compte, voir figure 5-3. 



M ais la structure d'arbre que doit verifier un TST pour Stre correct est moins contrai- 
gnante que eel I e imposee par le standard XML pour un document XM L. En effet, XML 
impose qu'un document commence par un seul element, appele element racine du 
document (la racine de I'arbreXM L n'a done qu'un seul enfant, qui est I 'element racine 
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du document) ; un TST est dispense de cette contrainte : non seulement il peut y avoir 
pi usieurs elements au premier niveau de I'arbre, mais deplus, il peut y avoir du texte non 
bal ise. L a forme la pi us generale d'un TST obtenu litteralement est done tout simplement 
eel le qui resulte de I 'i nstanciation d'un model ede transformation litteral (voir M od<?le de 
transformation litteral, page 81), commececi : 

<xsl :variable name="instrument"> 
viole de gambe 

<Interprete> Rika Murata </Interprete> 
<Interprete> Martin Bauer </Interprete> 
<Interprete> Sophie Wati 11 on </Interprete> 
</xsl :variable> 

lei, la racine du TST resultat de I 'evaluation de la variable instrument n'a pas un enfant 
unique, comme ce devrait etre le cas pour un document XML ; il y a en fait sept enfants 
accroches a la racine du TST («\n » designe unefin de ligne, et «\t » une tabulation) : 

• un premier enfant de type text : \n\tviole de gambe\n\t ; 

• un deuxieme enfant de type element : <Interprete> Rika Murata </Interprete> ; 

• un troisieme enfant de type text : \n\t ; 

• un quatrieme enfant de type element : <Interprete> Martin Bauer </Interprete> ; 

• un ci nquieme enfant de type text : \n\t ; 

• un Sixieme enfant de type element : <Interprete> Sophie Watillon </Interprete> ; 

• un septieme enfant de type text : \n\t. 

La figure 5-3 donne une representation graphique de cette structure d'arbre ; on pourra 
comparer avec la figure 6-2 qui montre une structure d'arbre XML correct. 



root 



text 

\n\tviole de 
gambe\n\t 




_ text 

Rika 
Murata 



Figure 5-3 

U n TST sans element racine unique. 
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TST calcule 

Lorsque I e model ede transformation associe a une instruction xsi variable contientdes 
instructions XSLT (c'est-a-dire des elements XML prefixes par "xsi :"), le TST n'est 
plusobtenu litteralement, il est calcule. Exemple: 

<xsl :variable name="inouvenient"> 
<insert> 

<Ensembl e> 

<NomXxsl :value-of select="NomEnsemble"/X/Nom> 

<Di recti onXxsl : val ue-of sel ect="Chef "/X/Di recti on> 

</Ensemble> 

<Concert> 

<DateXxsl :value-of sel ect="Date"/X/Date> 
<VilleXxsl :value-of select="Ville'7X/Ville> 
<LieuXxsl :value-of select="Salle"/X/Lieu> 
<TitreXxsl :value-of select="TitreConcert"/X/Titre> 
</Concert> 
</insert> 
</xsl :variable> 

Le TST obtenu en evaluant la variable mouvement est un arbre XML d'element racine 
<insert>, dont la descendance est constitute d'elements fixes (Ensemble, Nom, Date, 
etc.) : lesqueletteestimmuable, maisles contenusdes noeuds text qui lui sont rattaches 
sont calcules, done sont variables en fonction du document X M L qui subit la transforma- 
tion XSLT. 



Note 

II y aurait une autre facon d'envisager un TST calcule, ou le nom des elements seraient eux-memes calcules, au 
lieu d'etre fixes comme ici. C'est possible a realiser, il faut pour cela utiliser I'instruction xshelement. Nous 
verrons cela dans le chapitre sur les instructions de creation (voir Instruction xshelement, page 272). 

TST-texte 

II y a un cas particulier tres frequent deTST : c'est celui ou leTST ne contient que du 
texte. On peut dire que c'est une forme degeneree, en cesensqu'il n'y a plus vraimentde 
structure d'arbre, mais un simple nceud texte rattache a la racine. LeTST est alors a peu 
pres equivalent a une String. Exemple : 

<xsl variable name="instrument">saqueboute</xsl :variable> 

On peut comparer cette declaration de variable a eel I e-ci : 

<xsl :variable name="instrument" select="'saqueboute"7> 

Concretement, cesdeux declarations sont interchangeables, du moinssi le butestd'avoir 
une variable qui contienne une chaine de caracteres. En effetnous verrons (voir Opera- 
tions sur un TST (XSLT 1.1 ou plus), page 198) qu'un TST peuttoujoursetre converti en 
String ; dans lecasci-dessus, il est cl air que la conversion esttriviale. 
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On remarquera au passage que la declaration avec un modele de transformation est plus 
simple que eel le avec I 'attri but select, dans le cas oil la valeur a attribuer est une String 
litterale. En effet, pour indiquer une String litterale en tant que valeur d'attri but, il faut 
deux niveaux deguillemetsou apostrophes : 

<xsl :variable name="instrument" sel ect="saqueboute"/> <!-- faux ! --> 

Dans la declaration ci-dessus, ce n'est pas la String litterale "saqueboute" qui estfour- 
nie comme valeur d'attribut, e'est une expression Xpath qui est la forme courte de 
child: : saqueboute. L'expression va done selectionner un node-set constitue detous les 
elements filsdu nceud contextequi sontdes <saqueboute> ; il y a done toutes les chances 
que le resultat soit un node-set vide. Ensuite, si I'on reference la variable en question 
en ecrivant $instrument laou une String estattendue, le node-set (vide) seraconverti en 
String, ce qui donnera une String vide, et done un resultat inattendu. Ce genre d'erreur 
n'est pas forcement evident a detecter. 

Un TST reduit a un nceud texte n'est pas necessairement obtenu litteralement ; il est 
meme frequent qu'un TST-texte soit calcule. Exemple : 

<xsl :variable name="result"> 

<xsl :val ue-of select='concat( $repl acement, .)'/> 
</xsl :variable> 

Dans cet exemple, la variable result est associee a un modele de transformation, dont 
I'instanciation donnedonc unTST. CeTST contient une String dont la valeur est fournie 
par une instruction xsi :vaiue-of (dont I'attribut select contient une expression sans 
importance pour les explications) au lieu d'etre litterale comme dans I'exemple prece- 
dent. 

On peut aller plus loin dans la complexity du modele de transformation, sans que cela 
change la structure de TST-texte que I'on obtient lors de I'instanciation, meme si 
cela semble moins evident a la lecture : 

<xsl :variable name="result"> 

<xsl :variable name="begin" select="$fragments[position( ) = l]"/> 

<xsl :choose> 

<xsl :when test="starts-with( SunTexte, $givenChar )"> 

<xsl :value-of sel ect="$repl acement"/> 

<xsl :val ue-of select="$begin"/> 
</xsl :when> 
<xsl :otherwise> 

<xsl :val ue-of select="$begin"/> 
</xsl :otherwise> 
</xsl :choose> 

<xsl :for-each select="$fragments[position() > 1]"> 
<xsl :val ue-of select='concat( $replacement, .)'/> 
</xsl :for-each> 

</xsl :variable> 
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Cette fois, le model e de transformation a instancier est nettement plus complique ; mais 
la variable resui t est toujours associee a un TST compose d'une raci ne a laquelle est rat- 
tache un seul nceud text, contenant une chaine de caracteres qui est ici constitute petit a 
petit par tout un algorithme (sans interet pour les explications qui suivent). 

II faut remarquer que pour faciliter I'ecriture de cet algorithme, une variable auxiliaire 
begin a ete utilisee : et de fait, une instruction xsi :variat>ie pouvantapparaitre dans tout 
modelede transformation, rien n'interdit qu'elle apparaisse dans un modelede transfor- 
mation lui-meme associe a une declaration de variable. Dans cet algorithme, seules les 
instructions xsi :vaiue-of vont en fin de compte contribuer a constituer la chaine de 
caracteres finale, que I 'on retrouvera comme valeur du nceud textedu TST instancie. 

En effet, lors de I'instanciation de ce modele de transformation, seules les instructions 
xsi :vaiue-of seront remplacees par quelque chose; toutes les autres (xsi :variat>ie, 

xsi :choose, xsi :when, xsi rotherwise, xsi :for-each) SOnt remplacees par rien (c'est-a- 

dire sont supprimes : rien est la valeur de remplacement). 
Operations sur unTST (XSLT 1.1 ou plus) 
Attention 

Ce qui estditdans cette section ne s'applique pas a XSLT 1.0, mais aux versions ulterieures. 

UnTST est instancie lorsdu calcul de la valeur d'initialisation d'une variable possedant 
un modele de transformation ; quand on reference cette variable, on recoit en retour un 
node-set ne contenant qu'un seul nceud, la racine du TST. 

Ce node-set est alors utilisable partout ouun node-set est attendu, eton peut appl iquer a 
ce node-set toutes les fonctions XSLT ou expressions X Path standard. 

En particulier, il est assez frequent qu'un TST soitconverti en String, caril est assez fre- 
quent qu'un TST soit utilise dans sa forme degeneree, reduite a un simple texte. Dans ce 
cas, si on fournit un TST alors qu'une String est attendue, il y a conversion implicite du 
TST en String. Cette conversion peut intervenir aussi bien dans le cas ou leTST est un 
arbre a part entiere (c'est-a-dire un arbre qui n'est pas reduit a un nceud texte : la conver- 
sion d'un node-set en String s'applique alors), mais c'est moins interessant, done plus 
rarement utilise. 

Dans toute cette section, concernant I 'utilisation d'un TST en XSLT1.1 ou plus, nous 
fournirons des exemples avec la convention utilisee par Saxon 6.5, le processeur 
XSLT de M ichael Kay. Avec Saxon 6.5, la manipulation de TST au sein d'expressions 
XPath peut se faire sans conversion explicite en node-set, a condition de preciser une 
valeur superieure a "l.o' (par exemple "l.i') pour I ' attri but version de I'element 
<xsi :styiesneet>, commececi : 

Utilisation transparente d'un TST avec Saxon 6.5 

<xsl :stylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> 



Instruction xshvariable M 

Chapitre 5 | 

Exemples d'utilisation d'unTST (XSLT 1.1 ou plus) 

Utilisation d'un TST obtenu litteralement (XSLT 1.1 ou plus) 

U n TST obtenu litteralement sert en general a definir des constantes symboliques struc- 
tures. Ce sont des constantes parce que rien n'est calcule, et elles sont symboliques 
parce que le nom des balises employees va pouvoir servir a les references grace a une 
expression XPath adequate. 

Imaginons par exemplequel'on veuille obtenir une seriede pages HTM L ayanttoutes le 
meme en-tete ; on pourrait bien sfir declarer plusieurs variables enteteGauche, entete- 
centre, et enteteDroi te, et les referencer la ou on a besoin. M ais les avantages d'utiliser 
des variables structures (comme celles de type struct en C) sont connus ; ici on peut 
structurer ces trois informations en les regroupantdefacon hierarchique : 

Note 

Obtenir une seriede pages HTML implique bien surque I'on sache creer plusieurs fichiers de sortie, dontle nom 
est fourni par une expression adequate (de fagon a obtenir par exemple pagel.html, page2.html, etc.). La 
encore, il faudra patienter jusqu'a la version 2,0 du standard XSLT ; en attendant, on continuera a utiliser 
une fonction d'extension disponible (malheureusement sous des formes tres diverses) avec les principaux 
processeurs XSLT du marche. Un exemple est disponible a la section Pattern n '20 -Generation de documents 
multiples, page 563. 

<xsl :variable name="entete"> 
<hautDePage> 
<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

Voici le programme XSLT : 

Concerts .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="l.l"> 

<xsl:output method='html ' encoding=' ISO-8859-1 ' /> 



<xsl :variable name="entete"> 
<hautDePage> 
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<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /EnteteVX/titl e> 
</head> 

<body bgcol or="white" text="bl ack"> 

<TABLE valign="top" width="100r height="2%" B0RDER="0" > 
<TR> 

<TD align="left"> 
<xsl :val ue-of 

sel ect="$entete/hautDePage/gauche"/> 
</TD> 

<TD al ign="center"> 
<xsl : val ue-of 

sel ect="$entete/hautDePage/centre"/> 
</TD> 

<TD al ign="right"> 
<xsl :val ue-of 

sel ect="$entete/hautDePage/droite"/> 
</TD> 

</TR> 
</TABLE> 

<xsl : apply-templ ates/> 
</body> 
</html> 
</xsl : tempi ate> 

<xsl :template match="Entete"> 

<p> <xsl :val ue-of select="."/> presentent </p> 
</xsl : tempi ate> 

<xsl :template match="Date"> 

<H1 al ign="center"> Concert du <xsl :val ue-of select="."/> </Hl> 
</xsl : tempi ate> 

<xsl :template match="Lieu"> 

<H4 al ign="center"> <xsl :val ue-of sel ect=" . "/> </H4> 
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</xsl :template> 

<xsl :template match="Ensembl e"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of select="."/X/H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :val ue-of sel ect=" . "/> </H3> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

On applique cettefeui lie de style au fichier suivant(en faisant abstraction du problemede 
la generation de pages HTM L multiples) : 

Concerts .xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapel 1 e des Ursul es</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Composi teur>M. Marais</Composi teur> 

<Composi teur>D. Castel 1 o</Compositeur> 

<Composi teur>F. Rognoni</Composi teur> 
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</Compositeurs> 
</Concert> 

On obtient le resultat suivant (voir aussi figure 5-4) : 

Concerts.html 

<html xml ns :xal an="http://xml .apache.org/xal an"> 
<head> 

<META http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d’Anacréon </title> 

</head> 

<body text="black" bgcolor="white"> 

<TABLE BORDER="0" height="2%" width="100%" val ign="top"> 
<TR> 

<TD align="left"> 

musique 
</TDXTD al ign="center"> 

Anacréon 
</TDXTD align="right"> 

baroque 
</TD> 

</TR> 
</TABLE> 

<H1 align="center"> Concert du Jeudi 17 janvier 2002, 20H30</H1> 

</body> 

</html> 



Figure 5-4 

Transformation par 
Concerts.xsl. 



Netscape: Les Concerts d'Anacreon 
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Utilisation d'un TST calcule (XSLT 1.1 ou plus) 

On suppose ici que nous devons maintenir une base de donnees qui contient des en- 
sembles, et des dates et lieux de concerts, en vue d'editer un catalogue de festivals d'ete, 
par exemple. 

Cette base de donnees est mise a jour de differentes manieres ; I 'une d'entre dies consiste 
a exploiter trois fichiers qui arrivent periodiquement d'une source exterieure : un fichier 
rawinsert.xmi, qui contient des insertions a effectuer; un ficher rawUpdate.xmi, qui 
contient des mises a jour, et rawDeiete.xmi, qui contient des suppressions. 

Lefichier rawinsert.xmi ressemble a ceci : 
rawinsert.xmi 

<?xntl version="1.0" encoding="UTF-16" standalone="yes"?> 
<insertions> 
<Concert> 

<NomEnsembl e>A deux violes esgal es</NomEnsembl e> 
<Chef>-</Chef> 

<Date>Jeudi 17 janvier 2002, 20H30</Date> 

<Ville>Angers</Ville> 

<Salle>Chapelle des Ursules</Salle> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 

</TitreConcert> 
</Concert> 
<Concert> 

<NomEnsembl e>La Cetra d'Orfeo</NomEnsemble> 

<Chef>Michel Keustermans</Chef > 

<Date>Mercredi 20 Mars 2002, 20H30</Date> 

<Ville>Bordeaux</Ville> 

<Salle>Theatre</Salle> 

<TitreConcert> 
Habendmusi ken 

</TitreConcert> 
</Concert> 
<Concert> 

<NomEnsembl e>Suonare e cantare</NomEnsembl e> 

<Chef>Jean Gai 1 1 ard</Chef> 

<Date>Vendredi 26 octobre 2001, 20H30</Date> 

<Ville>Nantes</Ville> 

<Salle>Musee des Beaux-Arts</Sal le> 

<TitreConcert> 

Madrigal i e altre musiche concertate 
</TitreConcert> 
</Concert> 
</insertions> 

On veutfaire un fichier synthesedetous les mouvements a real i ser, suivant un format qui 
n'est pas forcement celui du fichier montre ci-dessus. 
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Par exempleon voudrait un fichier d'insertions se presentant comme ceci : 

insert .xml r 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Mouvements> 
<insert> 
<Ensembl e> 

<Nom>A deux violes esgales</Nom> 
<Di recti on>-</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Ville>Angers</Ville> 
<Lieu>Chapelle des Ursules</Lieu> 
<Titre> 

Folies d'Espagne et diminutions d'ltalie 
</Titre> 
</Concert> 
</insert> 
<insert> 
<Ensembl e> 

<Nom>La Cetra d'0rfeo</Nom> 
<Di recti on>Michel Keustermans</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>Mercredi 20 Mars 2002, 20H30</Date> 

<Ville>Bordeaux</Ville> 

<l_ieu>Theatre</l_ieu> 

<Titre> 

Habendmusi ken 
</Titre> 
</Concert> 
</insert> 
<insert> 
<Ensembl e> 

<Nom>Suonare e cantare</Nom> 
<Di recti on>Jean Gail 1 ard</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>Vendredi 26 octobre 2001, 20H30</Date> 

<Ville>Nantes</Ville> 

<Lieu>Musee des Beaux-Arts</Lieu> 

<Titre> 

Madrigali e altre musiche concertate 
</Titre> 
</Concert> 
</insert> 
</Mouvements> 

La transformation de structure peut se faire tres simplement : il suffit de « cabler » la 
nouvelle structure dans un modele de transformation. L'instanciation de ce modele de 
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transformation pour chaque <concert> rencontre dans le fichier donne rawinsert.xmi 
donnera le resultat souhaite : 

preparelnsert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' encoding=' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 

<Mouvements> 

<xsl :apply-templates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl :template match="Concert"> 

<xsl :variable name="mouvement"> 
<insert> 

<Ensembl e> 

<NomXxsl :value-of select="NomEnsemble"/X/Nom> 

<Di recti onXxsl : val ue-of sel ect="Chef VX/Di recti on> 

</Ensembl e> 

<Concert> 

<DateXxsl :value-of sel ect="Date"/X/Date> 
<VilleXxsl :value-of select="Vine"/></Vllle> 
<LieuXxsl :value-of select="Salle"/X/Lieu> 
<TitreXxsl :value-of sel ect="TitreConcert"/X/Titre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Soyons honnetes, si on lance la feui I lede style ci-dessussur I e fichier rawinsert.xmi, le 
resultat ne sera pas aussi beau que celui montre ci-dessus (fichier insert. xmi) ; en fait, 
voici qu'on aura : 

insert.xml 

<?xml version="l .0" encodings" ISO-8859-1 "?XMouvementsXinsertXEnseinbl eXNom> 
A deux violes esgales</NomXDirection>-</DirectionX/EnsembleXConcertXDate> 
Jeudi 17 janvier 2002, 20H30</DateXVille>Angers</VilleXLieu>Chapelle des Ursules 
</LieuXTitre> 

Folies d'Espagne et diminutions d'ltalie 
</TitreX/ConcertX/insertXinsertXEnsembleXNoin>La Cetra d'0rfeo</Nom> 
<Di rection>Michel Keustermans</DirectionX/EnsembleXConcertXDate>Mercredi 20 mars 
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2002, 20H30</DateXVille>Bordeaux</Ville><Lieu>Theatre</LieuXTitre> 
Habendmusi ken 

</Ti treX/ConcertX/insertXinsertXEnsembl e><Nom>Suonare e cantare</Nom> 
<Di rection>Jean Gaillard</DirectionX/EnsembleXConcertXDate>Vendredi 26 octobre 
2001, 20H30</DateXVille>Nantes</VilleXLieu>Musee des Beaux-Arts</LieuXTitre> 
Madrigali e altre musiche concertate 

</Ti treX/ConcertX/insertX/Mouvements> 

Pour obtenir un resultat lisible, il faut ajouter I'attribut indent='yes' dans instruction 
xsi :output, commececi : 

<xsl:output method='xml ' encodings' I S0-8859-1 ' indent='yes' /> 

Ceci dit, I'exemple que nous venons de montrer n'est pas speciflque a la version 1.1 ou 
plus de XSLT ; en effet leTST est utilise comme cible de I 'instruction xsi :copy-of, ce 
qui n'est pas interdit par XSLT 1.0. Nous verrons qu'une operation sur un TST est pos- 
sible en XSLT 1.0, a condition qu'elle soit applicable a une String (voir Operations sur 
un RTF (XSLT 1.0), page 209) ; or uneString peutetre copiee par un xsi :copy-of. 

Mais il est evident qu'un programme tel que celui montre ci-dessus, est susceptible 
d'evoluer, etqu'il est probable qu'un jour ou I'autre, on aura besoin d'ecrire : 

<xsl :copy-of select="$mouvement/insert/Ensemble'7> 

en plus de : 

<xsl :copy-of select="$mouvement"/> 

Cettefois, le programme sera incompatible avec la version 1.0 deXSLT, et il faudra alors 
declarer la valeur 1.1 pour I'attribut version de la declaration <xsi :styiesheet>, si tou- 
tefois on utilise le processeur Saxon 6.5. 

Utilisation d'un TST-texte pour le calcul de la valeur par defaut d'un attribut 



Remarque 

Ce qui est dit ici est compatible avec XSLT 1.0, parce que le TST utilise est seulementconverti en String, ce qui 
estpermis en XSLT 1.0, comme on le verra plus loin ( voir Operations surun RTF (XSLT 1.0), page 209). 



En XM L, il est possible, dans certaines conditions, qu'un element ait un attribut faculta- 
tif ; s'il est omis, I 'appl i cation de traitement du fichier XML est censee pouvoir affecter 
une valeur par defaut a cet attribut, si toutefois c'est necessaire. 

Pour faire cela en XSLT, rien de plus simple: il suffit de declarer une variable avec 
modele de transformation, contenant un calcul de valeur par defaut. Exemple : 

produits.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<LesProduits> 

<Livre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<ref0euvre> 

<Ref valeur="200001slm"/> 
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</refOeuvre> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" media="papier"> 
<refOeuvre> 

<Ref valeur="liatlc.bn"/> 
</refOeuvre> 
<Prix val eur="30"/> 
</Livre> 
</LesProduits> 

lei, on peut imaginer que I'attribut monnaie de I 'element <Prix> soit facultatif ; s'il n'est 
pas fourni, sa valeur sera « FF » par defaut. Voici comment proceder : 

produits.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="Livre"> 

<xsl :variable name="monnaie"> 
<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :val ue-of select="Prix/@monnaie"/> 
</xsl :when> 

<xsl :otherwise>FF</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

ref: <xsl :value-of select="@ref "/> 
prix: <xsl :value-of 

select="Prix/@valeur"/> <xsl :val ue-of select="$monnaie"/> 
</xsl : tempi ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

A pres execution, on obtient ceci : 
Resultat 

ref: vernesl 
prix: 40.5FF 



ref: boi 1 eaunarcejacl 
prix: 30FF 



■ Les instructions de programmation 

B I II Mill 

Dans le modele de transformation de la variable monnaie , on notera I 'alternative pour 
instancier leTST : dansune brancheon instancie une chaine de caracteres provenant de 
devaluation d'une expression, dans I'autre on instancie une valeur I itteral e (FF). Letest 
effectue, qui permet de savoir si la chaine de caracteres Prix/@monnaie est vide ou non, 
selectionne une des deux branches. 

Result Tree Fragment (XSLT 1.0) 

Attention 

Ce qui est dit dans cette section s'applique a XSLT 1.0 ; on peut ignorerdonc toutce qui suit si on travaille avec 
un processeurXSLT conforme aux propositions du XSLT Working Draft 1.1 ou 2.0. 

En XSLT 1.0, un modele de transformation associe a un element <xsi :variabie> ou 
<xsi:param> est un arbre XML, qu'on peut continuer a appeler un TST (Temporary 
SourceTree) ; jusque la, aucune difference avec ce qu'on a vu. La ou tout bascule, c'est 
que leTST n'est pas de type node-set, mais d'un type special, appele RTF (Result Tree 
Fragment). 

Un Result Tree Fragment (ou RTF) est un cinquieme type de donnee XSLT, qui vient 
done s'ajouter aux quatre types XPath que sont les types String, Number, Boolean et 
N ode- set. 

En XSLT 1.0, la notion de node-set est exclusivement reservee aux ensembles constitues 
de nceuds issus de I 'arbre XM L du document source XML a traiter. Les arbres XML 
provenant de I'instanciation d'un modele de transformation associe a une variable ne 
peuvent pas donner lieu a un node-set : ils sont comme pestiferes, et affubles d'un nom 
bizarre qui acheve leur mise a I'ecart. 

Note 

RTF veutdire Result Tree Fragment. 0 run RTF n'est pas un fragment d'arbre, mais un arbre, etil n'a pas force- 
ment a voir avec le document resultat de la transformation XSLT : c'est en cela que le nom RTF est un peu 
bizarre. 

Cette mise a I'ecart n'est pas seulement genante dans le principe, el I e I ' est aussi concre- 
tementcar elleempeche pratiquementtoute manipulation XPath sur un RTF. Or un arbre 
sans XPath, c'est comme un parachute sans suspentes: pas tres commode a utiliser. 
Impossible par exemple de recuperer la surface du bureau, quand on a ecrit : 

<xsl :variable name="maison"> 
<RDC> 

<cuisine surface='12in2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 
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<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 

Bibliotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 

alors qu'une expression du genre : 

<xsl :value-of sel ect="$mai son/RDC/bureau/@surf ace"/> 

semble pourtant parfaitement plausible et utile. Elle n'a que le tort d'etre interdite. 

On voit done que la fonction d'extension, disponible avec la plupart des processeurs 
XSLT (Xalan, Saxon, Xt...), permettant la conversion entre un RTF et un node-set ne fait 
que reparer une injustice, et n'a pas grand travail a effectuer vu I 'extreme ressemblance 
entre un RTF -set et un node-set. 

Cela etant, la future version XSLT2.0 de XSLT va operer sa revolution, et abolir ces 
arbres de seconde classe que sont les RTF ; un modele de transformation lie a une va- 
riable sera considers comme un nouveau et veritable document source, et une reference a 
cette variable renverra un node-set, auquel on pourra appliquer toutes les expressions 
XPath que I'on voudra. 

Operations sur un RTF (XSLT 1.0) 

Que peut-on faire d'un RTF ? Le langage XSLT (1.0) n'autorise que deux operations 
possibles sur un RTF : 

• On peut leconvertir en String, par application de la fonction standard stringo, impli- 
citement ou explicitement ; la conversion est implicite si le RTF figure comme valeur 
de I'attribut select de I 'instruction xsi :vai ue-of. 

Dans ce cas, la valeur du RTF convertie en String est egale a la concatenation de tous 
ses nceuds de type text, pris dans I'ordre de lecture du modele de transformation 
duquel le RTF provient. 

• On peut aussi le copier tel quel dans le document resultat de la transformation, en le 
donnant comme valeur de I'attribut select de I 'instruction xsl : copy-of . 

En resume, une operation est possible sur un RTF a condition qu'elle soit possible sur 
une String. 

A part ces deux operations prevuesdans le standard, les principaux processeurs XSLT du 
marche offrent une fonction d'extension permettant de convertir un RTF en node-set, ce 



Les instructions de programmation 

Chapitre 5 



qui ouvreconsiderablement le champ des possibility d'utilisation, dans la mesureou une 
variable associee a un RTF calcule peut alors etre considered comme une structure de 
donnees exploitable a I 'aide d'expressions XPath adequates, comme I'est un TST en 
XSLT 1.1. Tant qu'on n'a pas cette fonction de conversion, on peut certes creer la struc- 
ture de donnees, maison ne peut guere I 'exploiter, cequi est tout dememeassez rageant, 
il faut bien le reconnaitre. 

Pour montrer comment utiliser une telle fonction de conversion, nous allons reprendre 
I'exemple vu a la section Utilisation d'un TST obtenu litte'ralement (XSLT 1.1 ou plus), 
page 199. 

L e programme est legerement transforms, comme ceci : 

Concerts.xsl 

<?xml version="1.0" encoding="UCS-2"?> 
<xsl :stylesheet 

xmlns :xsl ="http: //www. w3.org/1999/XSL/Transform" 

xmlns:xalan="http://xml .apache.org/xalan" 

version="1.0"> 

<xsl:output method='html ' encodings' ISO-8859-1' /> 

<xsl :variable name="entete"> 
<hautDePage> 
<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /EnteteVX/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<TABLE valign="top" width="100r height="2%" BORDER="0" > 
<TR> 

<TD align="left"> 
<xsl : val ue-of 

se1ect="xal an :nodeset($entete)/hautDePage/gauche"/> 
</TD> 

<TD al ign="center"> 
<xsl : val ue-of 
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select="xal an :nodeset($entete)/hautDePage/centre"/> 
</TD> 

<TD al ign="right"> 
<xsl :val ue-of 

select="xal an:nodeset($entete)/hautDePage/droite"/> 
</TD> 

</TR> 
</TABLE> 

<xsl : apply-templ ates/> 
</body> 
</html> 
</xsl :template> 

<xsl : tempi ate match="Entete"> 

<p> <xsl :value-of select="."/> presentent </p> 
</xsl :template> 

<xsl :template match="Date"> 

<H1 al ign="center"> Concert du <xsl :value-of select="."/> </Hl> 
</xsl :template> 

<xsl :template match="Lieu"> 

<H4 al ign="center"> <xsl :value-of select="."/> </H4> 
</xsl :template> 

<xsl :template match="Ensembl e"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :val ue-of select="."/> </H3> 
</xsl :template> 

<xsl :template match="text( ) "/> 
</xsl :stylesheet> 

On remarquera la fagon dont on procede pour obtenir I'autorisation d'utiliser unefonc- 
tion d'extension : il faut declarer un nouveau domaine nominal, en pi us de eel ui d'XSLT, 
abrege en -xsi :". En I'occurrence, avec le processeur Xalan, le domaine nominal est 

http://xml .apache.org/xalan ; On choisit une abreviation (ici "xalan:"), et a I'appel, 

le nom de la fonction doit etre qualifie par I 'abreviation choisie : 

<xsl : val ue-of sel ect="xal an:nodeset($entete)/hautDePage/droite"/> 
Note 

Avec Saxon, on aurait a declarer le domaine nominal http ://icl.com/saxon. 
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Regies de visibility 

Les regies de visibilities indiquent si telle reference a une variable est autorisee, en fonc- 
tion de I'endroit ou est declaree la variable, et de celui ou el I e est referencee. 

Regies de visibilite pour les variables globales 

Pour les variables globales, les regies sont tres simples : une variable globale peut etre 
referencee de n'importe quel endroit du programme XSLT, a la seule condition que la 
declaration ne soit pas circulaire (c'est-a-dire que la declaration ne contienne pas, direc- 
tement ou indirectement, de reference a elle-meme) : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl :variable name="val eur"> 

<xsl :val ue-of select="$valeur"/> <!-- interdit ! --> 
</xsl :variable> 

<xsl : tempi ate match="TitreConcert" > 
</xsl :templ ate> 

<xsl : tempi ate match="Concert"> 
</xsl :template> 
</xsl :stylesheet> 

instruction ci-dessus xsi :vai ue-of avec son attribut seiect="$vaieur" est interdite 1 
(el I e introduit une circularite directe) ; de meme, le programme ci-dessous pourrait etre 
incorrect : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encodings ISO-8859-1' /> 

<xsl :variable name="truc"> 
<xsl :apply-templates /> 
</xsl :variable> 

<xsl : tempi ate match="TitreConcert" > 
</xsl :templ ate> 

<xsl :template match="Concert"> 



1. mais de la memefa^n, il nefaut pas oublier que c'est interdit defumer en jouant du hautbois. 
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<xsl : val ue-of select="$valeur"/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Remarquez ici le modele de transformation de la variable true : il contient une instruc- 
tion xsi :appiy-tempiates. Or, une variable globale estevaluee avec la racine de I'arbre 
XM L du document comme nceud contexte : I'instruction xsi :appiy-tempiates va done 
relancer le moteur XSLT sur I 'element fils de cette racine, puis eventuellement, sur 
d'autres elements, si d'autres instructions xsi :appiy-tempiates sont rencontrees. Rien 
ne dit que dans ce processus, le moteur selectionnera la regie <xsi template match= 
"Concerts. Si el I e n'est pas selectionnee, le programme ci dessus est correct, du moins 
quant a I 'evaluation de la variable true ; si el le est selectionnee, une circularite indirecte 
apparait, et le programme est alors incorrect. 

Eviter les circularites est la seule precaution a prendre dans la declaration et la manipula- 
tion de variables globales ; en particulier, il n'est pas interdit de referencer une variable 
dont la declaration n'intervientqu'un peu plus loin dans I'ordre de lecture du document : 
e'est ce qu'on appelle communement une reference avant dans les autres langages. Les 
references avant sont interdites en C, autorisees en Java, et aussi en XSLT, mais unique- 
ment pour les variables globales. 

Une autre source de circularite potenti el le serait la presence d'une reference de variable 
dans un motif. C'est pour cette raison que e'est interdit, ainsi que nous I'avons deja 
signale (voir Dans un motif, page 185). 

Si eel a etait possible, on pourrait ecri re quelque chose comme ceci : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl :variable name="amorce"> 

<xsl :apply-templates /> 
</xsl :variable> 

<xsl : tempi ate match="$amorce/ child: : Interprete/ child: :Nom" > 

</xsl :templ ate> 
<xsl : tempi ate match="..." > 
</xsl :templ ate> 
</xsl :stylesheet> 

II serait alors impossible d'evaluer le motif sans connaitre la variable ; mais I 'evaluation 
de la variable entraine une recherche de concordance de motif, qui ne peut s'effectuer 
tant que la variable n'est pas connue... 
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Regies de visibilite pour les variables locales 

Pour les variables locales, les regies sont un peu plus contraignantes, puisque les referen- 
ces avant sont interdites (la circularite directe ou indirecte etant absurde, el I e reste evi- 
demment interdite). Un programme XSLT est un document XM L, et en tant que tel, un 
arbre XM L lui est associe. Ce qui veut dire que la structure d'un programme XSLT est 
une structure deblocsjuxtaposesou imbriquesa volonte. Les regies de visibilite, pour les 
variables locales, sont eel les qui sont traditionnellement adoptees pour les langages a 
structure de blocs : unevariabledeclaree dans un bloc nepeutetre referenced que dans le 
meme bloc, ou dans n'importe quel bloc plus interne (cette regie est neutre vis-a-vis des 
references avant : I 'interdiction ou Pautorisation des references avant vient en plus). 

Remarque 

[.'interdiction des references avant est un peu contradictoire avec la nature declarative et fonctionnelle du 
langage XSLT, En tout cas, elle n'etait pas necessaire ; on peut penser qu'elle a ete decidee parce qu elle n'a 
rien de tres contra ignant, et qu'elle facilite notablementla lecture du programme. 

Les regies de visibilite des variables locales sont done une combinaison de la regie des 
blocs et de eel le des references avant; cela peut se resumer graphiquement, en faisant 
apparaitre les instructions XSLT comme des blocs numerates, et en montrant, pour une 
declaration de variable donnee, quels sont les blocs ou une reference a cette variable est 
autorisee (voir figure 5-5). 

Terminons en remarquant que I 'allusion aux langages a structure de blocs n'est pas abso- 
lument necessaire pour decrire les regies de visibilite en XSLT : XPath donne evidem- 
ment tout le vocabulaire adequat pour decrire ces regies sans parler de bloc. II suffit de 
dire que si on prend comme nceud contexte le nceud contenant la declaration d'une va- 
riable locale, alors les nceuds ou une reference a cette variable est autorisee sonttous les 
nceuds de I 'axe f oi 1 own ng-si bi i ng, ainsi que tous leurs descendants. 

Conflits de noms de variables 

II y a conflit de nom, si a un endroit donne d'un programme XSLT, il y a au moins deux 
variables de meme nom simultanement visibles. 

Un conflit de nom entre deux variables globales est interdit, de meme qu'entre deux 
variables locales. 

M ais un conflit de nom est autorise entre une variable globale et une variable locale. 
Dans ce cas, la variable locale masque la variable globale ; la valeur de la variable glo- 
bale n'est done pas disponible a I'endroit du conflit. 
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Instruction xs I: pa ram 

Les instructions xsi rvariabie et xsi rparam sont deux instructions voisines, tant sur le 
plan syntaxique que semantique. L'une declare une variable, et I'autre un parametre, 
c'est-a-dire quelque chose d'assez semblable a un argument formel de fonction dans un 
langage comme C ou Java. La difference essentielle entre variable et parametre est 
qu'une variable est declaree par une instruction qui lui donnesa valeur, alors qu'un para- 
metre est declare par une instruction qui ne lui donne qu'une valeur par defaut. 

Les parametres suiventexactement les memes regies de visibility que les variables, et les 
memes conflits de noms peuvent survenir, avec exactement les memes consequences et 
conclusions que ceux qui concernent des variables. 

De plus, etant donne la similitude entre variable et parametre, des conflits de noms croi- 
ses peuvent apparaftre, mettant en jeu une variable et un parametre, et pas seulement 
deux variables ou deux parametres. M ais a nouveau, la nature exacte (variable ou para- 
metre) des elements mis en jeu n'intervient pas ici, et ce cas se ramene a un conflit de 
nom entre deux variables. 

Bande-annonce 

Debut d'une feuille de style 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 
<xsl:param name="monnaieUsuelle" sel ect=" ' FF' "/> 



<xsl :value-of select="$monnaieUsuelle"/> 



Lancement du processeur XSLT 

Ijava com. i cl .saxon. Stylesheet 
-o produits.txt produits.xml produits.xsl monnaiellsuelle=DM 

La valeur du parametre monnaieusueiie est fourni dans la ligne de commande lors du 
lancement du processeur X SLT. L a valeur ff associee a ce parametre dans le programme 
XSLT n'est qu'une valeur par defaut. 

Syntaxe 

xsi :param 

<xsl:param name="..." select=" ... expression XPath ... "/> 
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Autre possibility : 

xsl : pa ram 

<xsl :param name=" . . . "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :param> 

L'instruction xsi : param peut apparaitre comme instruction de premier niveau. 
On voitquexsi :variabie etxsi :param partagent la meme syntaxe. 



Semantique 

Un parametre peut etre local ou global. S'il est local, il joue le meme role qu'un argu- 
ment formel de fonction en C ou Java. S'il est global, il joue le meme role qu'un 
argument formel de la fonction main en C ou Java, c'est-a-direqu'il permet de recuperer 
les arguments qui ont pu etre fournis lors du lancement du programme XSLT (mais le 
standard XSLT ne sped fie pas de quelle facon on peut transmettre des arguments au pro- 
gramme XSLT lors de son lancement). 

La valeur associee a un parametre lors desa declaration est une valeur par defaut, qui ne 
sera prise en comptequesi aucune valeur n'estfournie lors de I'appel. 

Utilisation d'un parametre global 

Reprenons I'exemple vu a la section Utilisation d'un TST-texte pour le calcul de la 
valeur par defaut d'un attribut, page 206, danslequel une variable servait a fai re I 'expan- 
sion de la valeur par defaut d'un attribut. Nous voulons maintenant que la monnaie par 
defaut ne soit plus codee en dur dans le programme, mais qu'elle soit parametrable en 
fonction des executions : 

produits.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl:param name="irionnaiellsuelle" sel ect=" ' FF"7> 

<xsl :template match="Livre"> 

<xsl :variable name="monnaie"> 
<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :val ue-of select="Prix/@monnaie"/> 
</xsl :when> 
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<xsl :otherwise> 

<xsl :value-of select="$monnaiellsuelle"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

ref: <xsl :value-of sel ect="@ref "/> 
prix: <xsl :val ue-of 

select="Prix/@valeur"/> <xsl :value-of select="$monnaie"/> 
</xsl :templ ate> 



<xsl :templ ate match="text( ) "/> 
</xsl :stylesheet> 

Si on lance I'execution decettefeui I lede style sans se preoccuper defournir une valeur 
au parametre monnaieusuei 1 e, on obtient le meme resultat que precedemment (voir U ti- 
lisation d'un TST-texte pour le calcul de la valeur par defaut d'un attribut, page 206) : 



Cela est du a ce que le parametre monnaieUsueiie a pris sa valeur par defaut (« FF »), 
etant donne qu'on ne lui a pas donne de valeur expliciteau lancement du programme. 

Pourfournir une valeur au parametre monnaieUsueiie, il fautse reporter a la documenta- 
tion du processeurXSLT que I 'on utilise. Un cas simple d' utilisation est eel ui oil on lance 
le programme via une ligne de commande sur le systeme hote (commande DOS sous 
Windows, commande shell sous Unix, etc.) ; dans ce contexte, la documentation fournie 
avec Saxon nousditceci : 

Using Saxon from the Command Line 

java com. icl .saxon. Stylesheet [options] source-document stylesheet [params...] 

The options must come first, then the two file names, then the params. 

A param takes the form name=value, name being the name of the parameter, and value 
the value of the parameter. These parameters are accessible within the stylesheet 
as normal variables, using the $name syntax, provided they are declared using a 
top-level xsl:param element. If there is no such declaration, the supplied parameter 
value is silently ignored. 

II suffit done de faire comme indique, e'est-a-dire de lancer le programme comme ceci 
(la ligne de commande est bien sflr d'un seul tenant, meme si la mise page la coupe en 
deux) : 




Resultat 



ref: vernesl 
prix: 40.5FF 



ref: boileaunarcejacl 
prix: 30FF 



Instruction xshtemplate H 
Chap7trF5~M 

Ligne de commande 

Ijava com. icl .saxon. Stylesheet -o produits.txt produits .xml produits.xsl 
monnaiellsuelle=DM 

Et voila le travail : 
Resultat 

ref: vernesl 
prix: 40.5FF 

ref: boi 1 eaunarcejacl 
prix: 30DM 

Ce qui correspond bien a ce qu'on attendait. 

Saxon n'estpasleseul processeurdu marche ; maistousfournissentun moyen de definir 
des valeurs de parametres via la ligne de commande ; par exemple, avec Xalan, on aurait 
a lancer la commande suivante, pour obtenir le meme resultat : 

Ligne de commande 

Ijava org. apache. xalan. xslt. Process -IN produits. xml -XSL produits.xsl -OUT 
produits.txt -PARAM monnaieUsuelle DM 

Utilisation d'un parametre local 

L'utilisation d'un parametre local est vraiment tres differente de celle d'un parametre 
global. On I'a vu, les parametres globaux servent a recuperer des arguments de la ligne 
de commande, fournis sous forme de paires (nom, valeur), d'une maniere qui n'est 
d'ailleurs pas specified par le standard XSLT. Si I'on n'a pas pour but une quelconque 
recuperation d'argument, mieux vaut, dans ce cas, utiliser une variable globale qu'un 
parametre global, car ^utilisation d'un parametre global suggere I'intention de trans- 
mettre un argument. 

Rien detoutcela pour un parametre local, qui, nous I'avonsdit, correspondrait plutota la 
notion d'argument formel de fonction, meme si la notion de fonction n'existe pas a pro- 
prement parler en XSLT. 

II est done impossible d'aller plus loin dans la comprehension des parametres locaux, 
sans aller faire un tour du cote des modules nomme's (<xsi template name=". . .">) etdes 
appels de modeles nommes (<xsi :caii-tempiate name=". . .">), que nous al Ions voir 
maintenant. 
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XSLT est un langage de transformation d'arbre. A ce titre la structure la plus importante 
du langage est sans aucun doute la regie, qui, associeeau moteur de transformation, per- 
met la transformation effective d'un arbreou d'une partie d'arbre. 
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Une regie est associee a un modele de transformation, qui consiste (en general) en une 
sequence de plusieurs transformations elementaires (par exemple, un xsl:value-of, suivi 
d'un autre xsl:value-of, suivi d'un xshif). Certaines sequences peuvent revenir a I'iden- 
tique dans plusieurs regies differentes, de meme que dans un programme en C, par 
exemple, une meme sequence d'instructions peut se retrouver a differents endroits du 
traitement. Dans les deux cas, I 'idee naturelle est alors de factoriser la sequence com- 
mune, etde lui donner un nom ; cela donneunefonction en C ou en Pascal, et un modele 
nomme en XSLT. 

Note 

La factorisation de code est la motivation la plus ancienne pour justifier I'emploi de fonctions ; il est evident qu'il 
y en a d'autres, ne serait-ce que le decoupage d'un code monolithique en petites unites semantiques plus faciles 
acomprendre eta maintenir. Cela vautbien sur aussi pour XSLT. 

Un modele nomme et une regie s'expriment tous les deux a I'aide d'une instruction 
xsi :tempiate ; ce qui I es difference d'un point de vue syntaxique, c'est que pour une 
regie, on specifie un attri but match=" . . . ", alors que pour un modele nomme, on specifie 
un attribut name=" . eton ne specirie pas d'attri but match. M ais rien n'interditde spe- 
cifier les deux attri buts match et name simultanement : dans ce cas, on a une regie nom- 
inee, c'est-a-dire un hybride qui peut etre selectionne comme une regie, ou appele 
comme un modele nomme. 

Bande-annonce 

Le modele nomme ci-dessous instancie un textefourni en parametre, en I'accompagnant 
d'un sautde ligneetd'un tiret. 

Nom.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl :template name="instancierTexteAvecTiret"> 

<xsl:param name="texte"/> 

- <xsl :val ue-of sel ect="$texte" /> 
</xsl :templ ate> 

<xsl : tempi ate match="Nom"> 

<xsl :cal 1 -tempi ate name="instancierTexteAvecTi ret"> 
<xsl :with-param name="texte" select="."/> 

</xsl :call-template> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 



</xsl :stylesheet> 
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Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapel 1 e des Ursul es</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 
<Compositeur>M 
<Compositeur>D 
<Compositeur>F 
</Compositeurs> 

</Concert> 

Leresultatobtenu estdonne ici en anticipant sur la prochaine instruction qui sera vueun 
peu plus loin (voir la section Instruction xsl : cal l-templ ate, page 229). 

Resultat 

- Jonathan Dunford 

- Sylvia Abramowicz 

- Benjamin Perrot 



. Marais</Compositeur> 
. Castel 1 o</Compositeur> 
. Rognoni</Compositeur> 
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Syntaxe 

Modele nomme xsl : tempi ate 

<xsl : tempi ate name="..."> 

<!-- arguments formels du modele nomine --> 

<!-- fin des arguments formels du modele nomme --> 
<!-- corps du modele de transformation --> 
... instructions ... 

<!-- fin du corps du modele de transformation --> 
</xsl :templ ate> 

Argument formel du modele nomme 

<xsl :param name=" . . . "/> 

Argument formel du modele nomme (avec valeur par defaut) 

<xsl:param name="..." select=" .. .expression XPath.../> 

Variante d'argument formel du modele nomme (avec valeur par defaut) 

<xsl :param name=" . . . "> 

<!-- modele de transformation du parametre --> 

<!-- fin du modele de transformation du parametre --> 
</xsl :param> 

L'i instruction xsi : tempi ate est une instruction de premier niveau ; il est done impossible 
de declarer un modele nomme a I'interieur d'un autre modele nomme. 

Les arguments formels sontfacultatifs, mais s'ils sont presents, ils doiventetre places en 
premier, avant le debut du corps du modele de transformation. 

Modele nomme typique 

U n modele nomme aura souvent la forme suivante : 

<xsl : tempi ate name="..."> 

<xsl:param name="truc"/> 

<xsl:param name="machin"/> 

<!-- corps du modele de transformation --> 

... reference a $truc ... reference a $machin ... 

<!-- fin du corps du modele de transformation --> 
</xsl :templ ate> 

Semantique 

U n modele nomme est i nstancie exactement comme peut I 'etre un modele de transforma- 
tion associe a une regie (e'est-a-dire un modele de transformation « ordinaire », comme 
tous ceux que nous avons vu jusqu'a present). 
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La seule chose qui difference I'instanciation d'un modele de transformation « ordi- 
naire » de celle d'un modele de transformation nomme, c'est la nature de I'evenement 
declencheur : dans le premier cas, c'est la selection d'une regie choisie par le moteur 
XSLT (apres recherche de concordance de motif) ; dans le deuxieme, c'est un appel 
explicite, du style : instancier le modele « tartampion » en lui fournissant les arguments 
« true » et « machin ». 

Mais une fois I'evenement declencheur passe, et I'instanciation en cours, plus rien ne 
distingue les deux types de model es de transformation. Done tout ce qui a ete vu dans a 
la section I nstanciation d 'un modele de transformation relativement a un nceud courant 
et une liste courante, page 90, reste valable pour I'instanciation d'un modele de transfor- 
mation nomme. 



Exemple 

Nous supposeronsici que nous voulons real iser un site Web d'annoncesde concerts, pre- 
sentees en francaisou en anglais. Une solution estdedupliquer lesite, afin d'en avoir une 
version francaise et une version anglaise. M ais c'est evidemment la mauvaise solution 
(maintenance en double, et risque d'incoherence entre les deux versions). Une meilleure 
solution consiste a maintenir un seul site, et a mettre en place un systeme de traduction 
automatique. Ici, la traduction automatiqueestenvisageable, car lesitenecontientaucun 
texte redactionnel : uniquement des noms propres (de personnes ou de villes), des dates 
et des noms d'instruments. 

L'idee est done de maintenir uniquement un fichier XML contenant les informations a 
publier, etde mettre au point un programme XSLT qui va generer le code HTM L tout en 
assurant la traduction. 

Afin de ne pas surcharger I 'exemple, nous nous contenterons de montrer comment rea- 
liser la traduction, en laissant de cote la generation de code HTM L, qui n'a rien de parti - 
culierement original ni interessant. 

Enfin, la traduction reposant sur un dictionnaire, il serait logique de penser que ce dic- 
tionnaire constitue un fichier XML separe, maintenu independamment du fichier XML 
des annonces. Cela implique I'utilisation de la fonction predefinie standard documentc ) 
poury acceder ; nous ferons done d'abord lechoix, un peu artificiel, il estvrai, de placer 
ce dictionnaire dans une variable globale codee en dur dans le programme XSLT. A ce 
titre, cet exemple constituera un complement interessant a eel ui etudie a la section Utili- 
sation d'unTST obtenu litte'ralement (XSLT 1.1 ou plus), page 199. Ensuitenous verrons 
comment uti I iser cette fonction standard do cument( ). 

Voici le fichier XML des annonces : 
annonces .xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<Annonces> 
<Annonce> 
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<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date> 

<Jour id="jeu"/> 

<Quantieme>17</Quantieme> 

<Mois i d=" jnv"/> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument id="bvl "/> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

instrument id="clv"/> 
</Interprete> 

<Concert> 

<TitreConcert lang="fr"> 

Folies d'Espagne, Bourrasque et Tourbillon 
Gavotte La Ferme - Chaconne de Rougeville 

</TitreConcert> 

<TitreConcert lang="en"> 

Spanish folias, Squall and Whirlwind 
Gavotte Shut Up - Redtown's Sillycate 

</TitreConcert> 
</Concert> 

<Compositeurs> 

<Compositeur>Marin Marais</Composi teur> 
<Compositeur>Jean de Sainte Colombe</Compositeur> 

</Compositeurs> 

</Annonce> 

<!-- autres annonces ... --> 
</Annonces> 
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Etvoici le programme XSLT : 

annonces.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :styl esheet xml ns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version="l . 1"> <!-- compatibility Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl :param name="langueCible">fr</xsl :param> 

<xsl :variable name="Dictionnaire"> 

<mot id="bvl"> 

<traduction 1 ang="f r">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 
</mot> 

<mot id="vdg"> 

traduction 1 ang="f r">Viol e de gambe</traduction> 
<traduction lang="en">Viola da gamba</traduction> 
</mot> 

<mot id="lth"> 

<traduction 1 ang="f r">Luth</traduction> 
<traduction 1 ang="en">l_ute</traduction> 
</mot> 

<mot id="clv"> 

traduction 1 ang="f r">Cl avecin</traduction> 
<traduction 1 ang="en">Harpsichord</traduction> 
</mot> 

<mot id="flt"> 

traduction 1 ang="f r">Fl ute a bec</traduction> 
<traduction 1 ang="en">Recorder</traduction> 
</mot> 

<mot id="thb"> 

traduction 1 ang="f r">Theorbe</traduction> 
<traduction 1 ang="en">Theorbo</traduction> 
</mot> 

<mot id="lun"> 

traduction 1 ang="f r">l undi</traduction> 
<traduction 1 ang="en">monday</traduction> 
</mot> 



<!-- etc. (les autres jours de la semaine) --> 
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<mot id="dim"> 
traduction 
traduction 

</mot> 

<mot id="jnv"> 
traduction 
traduction 

</mot> 



ang="fr">dimanche</traduction> 
ang="en">sunday</traduction> 



ang="f r">janvier</traduction> 
ang="en">january</traduction> 



<!- 



etc. (les autres mois de l'annee) --> 



<mot id="dcb"> 

traduction 1 ang="fr">decembre</traduction> 

traduction 1 ang="en">december</traduction> 
</mot> 

</xsl :variable> 

<xsl :template name="traduction"> 
<xsl:param name="motId"/> 

<xsl :variable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$mot Id]" /> 

<xsl :variable 

name="saTraduction" 

select="$motTrouve7traduction[@lang=$langueCible]" /> 

<xsl :val ue-of select="$saTraduction" /> 
</xsl :templ ate> 

<xsl : tempi ate match="Date"> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" select=" ./Mois/@id" /> 

</xsl :call-template> 
</xsl :templ ate> 

<xsl :template match="Interprete"> 

-<xsl :val ue-of select="./Nom"/> : 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" select="./Instrument/@id" /> 
</xsl :cal 1 -tempi ate> 
</xsl : tempi ate> 

<xsl :template match="text( )" /> 



</xsl :stylesheet> 
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La structure de ce programme XSLT est tres simple : un parametre global donnant la 
langue cible pour la traduction, une variable globale contenant la description X M L du 
dictionnaire, un modelenomme prenanten donnee un identifiant de mot, etinstanciantsa 
traduction dans la langue cible, et final ement deux regies, une pour I es dates, et une pour 
les instrumentistes, utilisantchacune le service de traduction offert par I e modelenomme. 

Le modele nomme recoit en donnee un identifiant de mot. Son instanciation commence 
par la constitution d'un node-set (variable motTrouve) contenant tous les elements <mot> 
du dictionnaire qui sont tels que leur attri but id soit egal a I 'identifiant de mot recu en 
donnee; normalement, si le dictionnaire est bien fait, le node-set obtenu ne doit pas 
contenir plus d'un element ; et si le mot que I 'on cherche a traduire existe effectivement 
dans le dictionnaire, le node-set contient au moins un element. 

Le node-set contient done final ement un et un seul element, un <mot>. 

L'instanciation du modele nomme se poursuit avec la constitution d'un node-set (va- 
riable saTraducti on) contenant tous les elements <traduction> enfants directs du nceud 
unique selectionne a I'etape precedente, tels que I 'attri but lang de chacun d'entre eux 
soit egal a la langue cible ; la encore, si le dictionnaire est bien construit, il n'y a qu'un 
seul element repondantau critere. Le node-set obtenu contient done un etun seul element 

<traducti on>. 

L'instanciation du modele nomme se termine avec l'instanciation de I 'instruction 
xsi :vaiue-of, qui en I'occurrence, est remplacee par la valeur textuelle du node-set ne 
contenant que cet unique element <traduction>, e'est-a-dire la valeur textuelle de cet 
unique element lui-meme. 

Note 

En general, ce n'estpas tres pertinent de faire calculerla valeur d'un node-set quelconque par xsl:value-of, car 
seul le premier nceud estpris en compte : les autres sont carrement ignores. Mais ici, il n'y a pas de question a se 
poser, puisque le node-set possede par construction un et un seul element : il n'y a done pas de perte en ligne. 

Reste a expliquer I'appel du modele nomme dans les deux regies qui I ' uti I i sent. Mais 
pour 9a, il nous faudra regarder de plus pres instruction xsi : can -tempi ate, ce que 
nous ferons a la section suivante. En attendant, voici comment utiliser la fonction 
documentc ) pour external iser le dictionnaire dans un fichier XML secondaire. 

Le dictionnaire sera place dans un fichier "dictionnaire.xmi " ; instruction a changer 
est bien sur I 'initialisation dela variable Dictionnaire : 

<xsl :variable name="Dictionnaire" select="document( 'dictionnaire.xmi ' )/Dictionnaire"/> 

L a fonction document ( ) peut etre appelee sous diverses formes, et nous aurons I 'occasi on 
de voir d'autres exemples d'appel ; celui montre ci-dessus est un des plus simples pos- 
sible : I 'argument est une chaine de caracteres representant I 'URL du fichier a lire. Le 
fichier doit etre au format XM L ; il est lu, converti en arbreXM L, et la fonction renvoi e 
un node-set contenant uniquement la racine del 'arbre. Notez bien qu'il s'agitdela racine 
del'arbre, et non dela racine du document. Done si I'on veutque la variable Dictionnaire 
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contienne comme dans la version precedente un node-set constitue de tous les <mot>, il 
faut I 'initialiser avec I'expression : 

documents 'dictionnaire.xml ' )/Dictionnaire 

et non pas seulement : 

documents 'dictionnaire.xml ' ) 

Une amelioration possible serait que le nom du fichier fourni comme argument de la 
fonction document ( ) ne soit qu'une valeur par defaut, la vraie valeur etant fournie comme 
parametre dans la ligne de commande. On aboutirait alors a la version finale suivante : 

annonces.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl :param name="langueCible">fr</xsl :param> 

<xsl :param name="dicoFileRef">dictionnaire.xml</xsl :param> 

<xsl :variable name="Dictionnai re" 

sel ect= " document ( $di coFi 1 eRef )/ Diet ionna ire" /> 

<xsl :template name="traduction"> 
<xsl:param name="motId"/> 

<xsl :variable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$mot Id]" /> 

<xsl :variable 

name="saTraduction" 

sel ect="$motTrouve7traduction[@l ang=$l angueCibl e]" /> 

<xsl :value-of select="$saTraduction" /> 
</xsl :template> 

<xsl : tempi ate match="Date"> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" select="./Mois/@id" /> 
</xsl :call -template> 
</xsl :templ ate> 

<xsl : tempi ate match=" Interprete"> 

-<xsl :value-of sel ect=" . /Nom"/> : 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" select="./Instrument/@id"/> 
</xsl :call-template> 
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</xsl :templ ate> 

<xsl : tempi ate match="text( )" /> 
</xsl :stylesheet> 

Le fichier dictionnaire reprend les donnees qui se trouvaient auparavant dans la variable 

Di cti onnai re : 
dictionnaire.xml 



<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<Dictionnaire> 

<mot id="bvl "> 

traduction 1 ang="f r">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 

</mot> 

<mot id="vdg"> 

traduction lang="fr">Viole de gambe</traduction> 
traduction lang="en">Viola da gamba</traduction> 

</mot> 



<!-- etc. 



(comme avant) 



-> 



<mot id="dcb"> 

<traduction 1 ang="f r">decembre</traduction> 
traduction 1 ang="en">december</traduction> 
</mot> 
</Dictionnaire> 

Apres ce petit detour par la fonction documento, nous revenons maintenant au propos 
initial, I'appel d'un modele nomme. 



Instruction xshcall-template 

L'instruction xsi : can-template permet de lancer I'instanciation d'un modele nomme. 



Bande-annonce 



Voir la bande-annonce del 'instruction <xsi : tempi ate name=". . ."> (voir Bande-annonce, 
page 220). 



Syntaxe 



xsl : call -tempi ate 

<xsl : call -tempi ate name="..."> 

<!-- arguments effectifs pour I'appel 
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<!-- fin des arguments effectifs pour l'appel --> 
</xsl :call-template>/> 

Argument effectif 

<xsl :with-param name="..." select="... expression XPath ..." /> 

Variante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de 1 'argument effectif --> 

<!-- fin du modele de transformation de 1 'argument effectif --> 
</xsl :with-param> 

instruction xsi :caii -template ne doit pas apparaltre en tantqu'instruction de premier 
niveau. 



Semantique 

LorS de SOn instanciation, ^instruction <xsl :call-template>. . .</xsl :call-template> 

est remplacee par sa valeur, qui n'est autre que eel le resultant de I 'instanciation du 
modele nomme (voir figure 5-6, qui montre sur I'exemple precedent quelle peut etre la 
valeur d'instanciation d'un appel de modele nomme). 



ProgrammeXSLT 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl stylesheet 

xmlns:xsl="http://www. w3.org/1999/XSL/Transform" 
xmlns:saxon=" http://icl.com/saxon" 
version="1.0"> 

<xsl:output method='text' encoding='ISO-8859-l'/> 
<xsl : param name=" I angueC i bl e" >f r</xsl : param > 



Annonces 
Annonce 




Nom 

Sylvia 



I nstrument 

id="bvl" 



<xsl template match=" I nterprete" > 

- <xsl:value-of select="./Nom"/> : 

<xsl:call-templatename="traduction"> 
<xsl:with-param 
name="motld" — 
selects" ./I nstrument/® id" /> 

</xsl:call-template> 

<yxsl:template> 

Instanciation 



Abramowicz 



Basse deviole 



Figure 5-6 

Valeur d'instanciation possible pour un appel de modele nomme. 



Instruction xshcall-template H 
Chap7trF5~M 

L'instanciation du modele nomme se passe en deux temps : 

(1) les arguments effectifs sont evalues, et donnent leur valeur aux arguments formels. 
S'il y a un argument effectif dont le nom ne correspond aaucun argument formel, il 
est tout simplement ignore, et ce n'est pas une erreur ; s'il y a un argument formel 
dont le nom ne correspond aaucun argument effectif, sa valeur par defaut entre en jeu 
et lui donne sa valeur. 

(2) la valeur de tous les arguments formels etant connue, I e modele nomme est alors ins- 
tance comme n'importe quel autre modele de transformation : tout se passe comme 
si les arguments formels etaient des variables declarees au debut du modele, avec une 
valeur precisement egale a eel le qui vient d'etre calculee (voir figure 5-7). On est 
done ramene a l'instanciation d'un modele de transformation comportant des decla- 
rations de variables locales, que nous avons deja vue a la section Utilisation d'une 
variable, page 184. Lors de l'instanciation, le nceud courant et la liste courante res- 
tent identiques a cequ'ils etaient au moment du can -tempi ate, cequi permetd'eva- 
luer les expressions X Path contenues dans le modele nomme comme si el les avaient 
ete directement ecrites dans le modele contenant I 'appel cai l -tempi ate. 

Les appels recursifs ne sont pas interdits ; mais comme d'habitude en pareil cas, il faut 
s'assurer que I'appel recursif ne va pas engendrer de recursion infinie. 

Note 

Au cas ou vous ne seriez pas a I'aise avec la recursion, reportez-vous au chapitre sur les patterns de program- 
mation, qui donne quelques rappels sur la recursion, montre comment I'utiliser, dans quels cas I'utiliser, etsitue 
son importance relativementaux autres notions ou techniques propres aXSLT. 

Exemple 

Tous les elements sont maintenant reunis pour que I'exemple vu a la section Exemple, 
page 223, soit completement analysable ; ils sont resumes a la figure 5-7. 

On lance le programme XSLT comme ceci : 

Ligne de commande 

java com. icl .saxon. Stylesheet -o annonces.txt annonces .xml annonces.xsl 

Etvoici le resultat obtenu : 

Resultat 

janvi er 

- Jonathan Dunford : 
Basse de viole 



- Sylvia Abramowicz : 
Basse de viole 
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M odele 



<xsl:value-of select="./Nom"/> 



<xsl:call-template name-'traduction" 
<xsl:with-param 
name-'motld" 

select- 1 ./Instrument/® id" /> 
</xsl:call-template> 



I nstanciation du 
template 
(2) 



Evaluation de 
I 'argument 
motld 
(1) 



\ 



Fragment de 
document resultat 



recopie 

evalue 
recopie 

1+2+3+4+5+6 



Sylvia Abramowicz 



Basse deviole 



Instruction fictive : voir texte decrivant 
les deux etapes de I'instanciation d'un 
xslxall-template 



<xsl:variable name= "motld" select='"bvl'"/> 



<xsl:vari able 
name-'motTrouve" 
select="saxon:node-set($Dictionnaire)/ 
mot[@id=$motld]" /> 

<xsl:vari able 
name-' saT reduction" 
select-' saxon:node-set($motTrouve)/ 
traduction[@lang=$langueCible]" /> 

<xsl:value-of select="$saT reduction" /> 



(3) 
(4) 

(5) 
(6) 



Basse deviole 



Figure 5-7 

Les e'tapes de I 'instantiation d 'un appel de module nomme. 
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- Benjamin Perrot 
Theorbe 



- Freddy Eichelberger 
Clavecin 



On lance le programme XSLT commecela : 

Ligne de commande (une seule ligne d'un seul tenant) 

Ijava com. icl .saxon. Stylesheet -o annonces.txt annonces.xml annonces.xsl 
langueCible=en 

Et voila le resultat : 

Resultat 

January 



- Jonathan Dunford : 

Bass viol 

- Sylvia Abramowicz : 

Bass viol 

- Benjamin Perrot : 

Theorbo 

- Freddy Eichelberger 

Harpsi chord 



Instruction xshapply-templates 

L'instruction xsi :appiy-tempiates a deja ete vue (voir section Instruction xshapply- 
templates, page 131) ; nous la revoyons ici a cause du fait qu'une regie et un modele 
nomme peuvent donner un hybride (voir Instruction xsl : template, page219). Une regie 
pouvant declarer des parametres, il est done logique que la regie selectionne puisse en 
recevoir. 



xsl :app1y-templates 

<xsl :apply-templates select***..." mode="..."> 
<!-- arguments effectifs pour 1'appel --> 

<!-- fin des arguments effectifs pour 1'appel --> 
</xsl :apply-templates>/> 



Syntaxe 



Argument effectif 

<xsl :with-param name**"..." select* 5 "... expression XPath ..." /> 
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Variante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de 1 'argument effectif --> 

<!-- fin du modele de transformation de 1 'argument effectif --> 
</xsl :with-param> 

L'instruction xsi :appiy-tempiates ne doit pas apparartre en tant qu'instruction de pre- 
mier niveau. Les attributsmode et select sont facultatifs. 

Semantique 

La seule chose nouvelle est la presence des arguments effectifs (xsi :with-param) dans I e 
model ede transformation dexsi :appiy-tempiates. S'il y a des parametres, ilssonteva- 
lues et transmis aux regies selectionnees. Ce n'est pas une erreur si I'une d' el les ne prend 
pas d'argument en donnee, et ce n'est pas non plus une erreur si I'une d'elles prend en 
donnee un parametre qui n'est pas transmis. 

J 'avoue m'etre creuse la tete pour trouver un exemple interessant de transmission de para- 
metre a une regie XSLT par I 'intermediate d'une instruction <xsi :appiy-tempiates>. 
Sans resultat sur le moment ; mais en faisant tout autre chose, je suis tombe sur un cas oil 
c'est vraiment utile. Rendez-vous done a la section Pattern n° 18 - Localisation d'une 
application, page 533 pour un exemple i 1 1 ustrant cette notion. 

Instruction xshmessage 

L'instruction xsi :message affiche un message et eventuellement, arrete I 'execution du 
processeurXSLT. 

Syntaxe 

xsi :message 

<xsl :message> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :message>/> 

xsi :message (variante syntaxique) 

<xsl :message terminate="yes"> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :message>/> 

L'attri but facultatif terminate^. . ." peut recevoir deux valeurs possibles : yes ou no. 
La valeur no est la valeur par defaut. 
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instruction xsi:message ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Semantique 

L'instanciation de I 'instruction <xsi :message> se traduit par I'instanciation de son 
model e de transformation, qui est ensuite sorti quel que part de telle sorte que I 'util isateur 
puisse le voir. Cela peut etre par exemple une boite d'alerte, la sortie standard d'erreur, 
ou autre (le standard XSLT ne specifie pas la nature exacte de la sortie). 

En general, le model e de transformation contient uniquement du texte, mais le standard 
ne I'impose pas. Rien n'interdit que des elements XML soient instancies, mais que 
pourra bien faire une bolte d'alerte de texte balise en X M L ? 

L es messages sont general ement des messages d'erreur, mais ce n'est pas une obligation. 
Lorsque I'attribut terminate est present avec la valeur yes, I 'execution du processeur 
XSLT s'arreteapres la sortie du message, etle document resultat en coursde constitution 
est mis a la poubelle. 

Lefait que la sortie utilisee pour un message ne soit pas bien definie en reduit un peu la 
portee. Avec Saxon, par exemple, le message est affiche sur la sortie standard d'erreur ; 
on peut done I'utiliser en complement de <xsi :comment> pour faire du depistage 
d'erreurs : <xsi :message> pour attirer I'attention sur le fait qu'une condition anormale 
est survenue, et <xsi :comment> pour afficher la trace sans perturber la sortie quand tout 
va bien. M ais si les messages sortent dans des boftes d'alerte, cela peut devenir tres vite 
exasperant de devoir les refermer sans arret. 



Instruction xshkey 

L'instruction xsi :key etablit une declaration d'association entre des nceuds d'un arbre 
XML source et des valeurs. 

Bande-annonce 

Dictionnaire.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Dictionnai re> 
<mot id="dim"> 

traduction 1 ang="f r">dimanche</traduction> 

traduction 1 ang="en">sunday</traduction> 
</mot> 

<mot id="lun"> 

traduction 1 ang="f r">l undi</traduction> 

<traduction 1 ang="en">monday</traduction> 
</mot> 
</Dictionnaire> 
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Declaration de cle 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 

Apres avoir declare la cle, on peut utiliser la structure obtenue grace a la fonction keyo, 
a qui I'on transmet le nom de la cle , ainsi que la valeur de cle. Elle renvoie un node-set 
qui contient leou les nceuds qui ontete attaches a cette valeur par une declaration de cle 
comme celle montree ci-dessus (voir figure 5-8, page 236). 




unM ot 



<xsl:variable name="unM ot" sel ect=" key ( 'trad u cti on ', lun') "/> 

Figure 5-8 

Utilisation d'unecle. 

Syntaxe 

xsl : key 

<xsl:key name="..." match=" .. .motif ... " use=". . .expression. . ."/> 

L'instruction xsi : key est une instruction de premier niveau, et de premier niveau unique- 
ment. 
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Ni le motif, ni I'expression, ne peuvent contenir des references a des variables ou des 
appels a la fonction predefinie key(). Les instructions xsi :key sont evaluees avant les 
variables global es. Ces restrictions ont pour but d'empecher d'eventuelles circularites. 

Semantique 

L'instruction xsi : key declare une cle. 

Une cle possede un nom et associe des valeurs a des nceuds. Le nom est fourni par 
I ' attri but name, et les nceuds concerned sont ceux (d'un certain arbre XML source) qui 
concordent avec le motif de I 'attri but match ; quand un nceud concorde avec le motif, sa 
valeur-cle est celle qui resulte de devaluation de I'expression donnee par I 'attri but use, 
en prenant ce nceud comme nceud contexte. 



Remarque 

Notez ce point extreme me nt important : I'arbre XML source dans lequel serontcherches les nceuds concordats 
n'est pas determine. L'instruction xsl :key ne fait rien, en elle-meme. Son effet sur le processeur XSLT est 
simplement de lui demander de noter au passage les trois attributs name, match, et use, mais pas d'effectuer 
une recherche ni de construire une table d'associations. 

L'instruction xsi :key ne s'utilise jamais seule, car son instanciation ne produit rien. De 
memequ'une declaration de variable x n'a de sens que si une reference $x a cette variable 
existequelque part, de meme une instruction xsi :key n'a de sens que par rapport a ('uti- 
lisation de la fonction predefinie key(). 

Dans le cas le plus simple, lors d'un appel a la fonction key(N, v), on transmet en argu- 
ment le nom N de la cle (qui doit se retrouver en tant qu'attribut name d'une instruction 
xsi :key), etunevaleurV de type string. Untel appel intervient necessairement dans une 
expression, ou un nceud contexte est defini, puisqu'un nceud contexte est toujours defini 
pour devaluation d'une expression. Ce nceud contexte fait partie d'un arbre XML 
source; cetarbreXML source est eel ui qui sera explore pour determiner les associations 
nceuds/valeurs. L'effet est le suivant : 

• la table des associations pour cette cle N etce document source est construite, amoins 
que cela ne soit deja fait (a cause d'un precedent appel) ; 

• le node-set des nceuds associes a la valeur V est extrait de cette table, et renvoye 
comme resultat. 

Le temps perdu a construire la table peutetre largement regagne ensuite car lesacces aux 
node-sets par leur valeur-cle sont quasi ment instantanes, en tout cas independants du 
nombre de nceuds de I 'arbre XML source. 

Ceci etant, il y a maintenant deux aspects essentiels et complementaires a voir, e'est la 
mani ere dont cette f ameuse tabl e est construite, et eel I e dont el I e est exploit.ee. 
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Remarque 

Pour etre honnete, il faut signaler ici que tout ce qui vient d'etre explique est assez eloigne de la presentation 
faite parle standard XSLT, qui ne parle absolumentpas de table, nide sa construction, ni de temps gagne, ni de 
temps perdu ; qui ne ditpas que Instruction xsl :key nefaitapeu pres rien, ni ne ditque c'est I'appel a la fonc- 
tion key( ) qui declenche tous les traitements. En fait, le standard se place a un niveau plus abstrait, contraire- 
ment aux explications donnees ici, qui font reference a des techniques d'implementation, notamment par table 
associative. Neanmoins, il esttres difficile de se figurerle fonctionnementdu couple instruction xsl :key /fonc- 
tion key( ) sans avoir un modele de traitement present a I'esprit pour guider la pensee. Le modele de traitement 
presente ici, a base de table associative, n'est pas impose par le standard, mais il va tellementde soi qu'il est 
difficile d'imaginerun processeurXSLT s'en ecartantfondamentalement. 

De toute facon, cette presentation des choses centree surl'emploi d'une table associative n'est pas fonctionnel- 
lementfausse : au pire, on peutdire qu'une implementation pourrait legitimementreposersurdes techniques 
totalement differentes, a condition que I'effet obtenu soit le meme, abstraction faite des questions de perfor- 
mance etde rapidite d'acces. 



Construction et exploitation de la table associative 

Unecle possede un nom et associe des valeurs a des nceuds : on a done affaire a une rela- 
tion ternaire entre cles, valeurs et nceuds, dont le but est d'indexer des nceuds par des 
valeurs. Le modele presente figure 5-9 resume eel a graphiquement. 




Figure 5-9 

L 'association cle, 
valeur, nom. 




Le modele de la figure 5-9 se lit comme ceci : 

• il y a une action «Associe» (c'est une association) 
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• unecle est I'agent decette action (c'est elle qui fait I'action) ; 

• une val eur est I 'objet decette action (c'est a elle que I 'action s'applique) ; 

• un nceud estun autre objet decette action (c'est aussi alui que I'action s'applique). 
Lesnombres« 1 » et« l+» (1 ou plus) indiques sont les cardinal ites ; elles se lisentainsi : 

• unecle peut etre I 'agent de une ou pi usieurs associations ; 

• une association a pour agent une seule cle ; 

• une valeur peut etre I 'objet de une ou plusieurs associations ; 

• une association peut avoir pour objet une ou plusieurs val eurs ; 

• un nceud indexe peut etre I 'objet de une ou plusieurs associations ; 

• une association peut avoir pour objet une ou plusieurs noeuds indexes. 

Dans la pratique, toutes ces combinaisons peuvent se produire, nous verronscela sur des 
exemples. 

Lorsd'un appel a lafonction keyo, le nceud contexte del 'expression englobante est fixe. 
Ce nceud contexte designe implicitement I'arbre X M L a explorer pour construire la table. 
D'autre part, le premier argument de I'appel est le nom de la cle : il faut done trouver 
^instruction xsi :key dont I'attribut name a pour valeur ce nom. L'ayant trouvee, on a 
alors un motif (attri but match) et une expression (attri but use). Si on n'en trouveaucune, 
c'est une erreur, maissi on en trouve plusieurs, on n'en rejetteaucune ; nousverronsplus 
bascequ'on en fait. Pour I 'instant, nouscontinuonsen supposantquel'on a trouve exac- 
tement une instruction xsi :key. 

La construction de la table d'association implique une exploration complete de la total ite 
des nceuds de I'arbre source : pour chacun d'eux, on teste sa concordance avec le motif. 
S'il n'y a pas concordance, le nceud est ignore ; s'il y a concordance, I'expression est 
evaluee en utilisant ce noeud comme nceud contexte. L'evaluation de cette expression 
peut donner un node-set ou non : 

• Si le resultat n'est pas un node-set, il estconverti en string, et cette valeur est la valeur 
de la cle. Le nceud concordant est done range dans la table, associe a cette valeur de 
cle. 

• Si le resultat estun node-set, la valeur textuelledechaque nceud estcalculee; cesdif- 
ferentes valeurs textuel les sont autantdevaleurs-cle pour le nceud concordant, qui est 
done range dans la table, associe a chacune de ces valeurs. 

Si on trouve plusieurs instructions xsi :key de meme valeur d'attri but name, la table est 
construite en utilisant le motif et I'expression de la premiere instruction trouvee, puis 
chaque instruction xsi:key supplemental re donne un nouveau motif et une nouvelle 
expression, qui donne lieu a une nouvelle exploration de I'arbre source : la table est sim- 
plement mise a jour en y ajoutant les nouvel les associations qui decoulent de chaque nou- 
velle exploration. 
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Note 



En deuxieme lecture, il pourra etre interessantde faire le rapprochement entre les figures qui arriventmaintenant 
(figures 5-10, 5-11, 5-12 et 5-13) etla figure 8-1 de la section Pattern n*9 -Identitede nceuds et node-set de 
valeurs toutes differentes, page 434. 

Une association d'une valeur a un nceud 

C 'est la situation la plus si mple ; el I e est resumeedansla figure 5-10, qui montrela struc- 
ture logique de la table d'association, construite a partir du fichier Dictionnaire.xmi 
(voirci-dessous) etde la declaration : 

Declaration de cle 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 



• root 



Nceud 
Indexe 



(l <Dictionnaire> 




Valeur 




traduction 



<traduction> 



dimanche 




<Mot>rdTm 



<traduction> 



Sunday 



Figure 5-10 

U ne association d 'une valeur a un n«ud. 
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Dictionnaire.xml 



<?xml version="1.0" 
<Dictionnaire> 



encoding="UTF-16"?> 



<mot id="dim"> 
<traduction 
<traduction 



1 ang="f r">dimanche</traduction> 
1 ang="en">sunday</traduction> 



</mot> 
</Dictionnaire> 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 

<xsl :template name="afficher"> 
<xsl:param name="code"/> 

<xsl :variable name="mot" select="key( 'traduction' , $code)"/> 

<xsl :for-each select="$mot/traduction"> 

<xsl :value-of select="$code"/Xxsl :text> ( </xsl:text> 
<xsl :val ue-of select="@lang"/Xxsl :text> ) : </xsl:text> 
<xsl :val ue-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="/"> 

<xsl :call-template name="afficher"> 

<xsl :with-param name="code" select="'dim"7> 

</xsl : call -tempi ate> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Resultat 

dim ( fr ) : dimanche 
dim ( en ) : Sunday 

Lorsde I'appel a la fonction keyo, lenceud contexteest la racinedel'arbreXM L source 
(car I 'instruction can -template ne change pas lenceud contextecourant) ; done e'estcet 
arbre qui est explore pour construire la table. 

Voyons maintenant comment evolue la table si I'on rajoute une entree dans le diction- 
naire. 



Les instructions de programmation 

Chapitre 5 

Deux associations, avec une valeur et un nceud par association 

Nousreprenonsexactementla meme declaration decle, maisavec un dictionnaire a deux 
entrees : 

Dictionnaire.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Dictionnai re> 
<mot i d="dim"> 

traduction 1 ang="f r">dimanche</traduction> 
<traduction 1 ang="en">sunday</traduction> 
</mot> 

<mot id="lun"> 

traduction 1 ang="f r">l undi</traduction> 

<traduction 1 ang="en">monday</traduction> 
</mot> 
</Dictionnaire> 

La figure 5-11 resume graphiquement ce que cela donne. 




.root 



dim 




Valeur 



<Mot>riun 



<traduction> 



monday 



Figure 5-11 

Deux associations, avec une valeur et un nceud par association. 
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traduction.xsl 

... idem ... 

<xsl : tempi ate match="/"> 

<xsl :cal 1 -tempi ate name="afficher"> 

<xsl :with-param name="code" select="'dim"7> 
</xsl : call -tempi ate> 
<xsl :call-template name="afficher"> 

<xsl :with-param name="code" sel ect=" ' 1 un "7> 
</xsl : call -tempi ate> 
</xsl :templ ate> 
... idem ... 

Resultat 

dim ( fr ) : dimanche 

dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 

Deux associations, avec deux valeurs et un nceud par association 

Nous gardons ici lememedictionnaire, mais nous changeons la declaration decle : 

Declaration de cle 

<xsl:key name="traduction" match="mot" use="traduction" /> 

Chaque <mot> du dictionnaire concorde avec le motif ; pour chacun d'eux, I'expression 
evaluee est done : 

./child: : traduction 

oft "." est le <mot> courant. 

Cette expression selectionne pour chaque <mot> un node-set dedeux elements, puisqu'il 
y a deux traductions par mot. Done ici, chaque mot va etre associe a deux valeurs, qui 
sont I es valeurs textuel I es des elements <t raducti on>. L a figure 5-12 resume cela graphi- 
quement. 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl:key name="traduction" match="mot" use="traduction" /> 

<xsl :template name="afficher"> 
<xsl:param name="unMot"/> 

<xsl :variable name="motTrouve" select="key( 'traduction' , $unMot)"/> 
<xsl :variable name="sonCode" select="$motTrouve/@id"/> 



<xsl :for-each select="$motTrouve/traduction"> 
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<xsl :value-of select="$sonCode"/Xxsl :text> ( </xsl:text> 
<xsl :value-of select="@lang"/Xxsl :text> ) : </xsl:text> 
<xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl : tempi ate> 

<xsl : tempi ate match="/"> 

<xsl : call -tempi ate name="aff i cher"> 

<xsl :with-param name="unMot" select=" 'dimanche"7> 
</xsl :call-template> 
<xsl :call-template name="affi cher"> 

<xsl :with-param name="unMot" select=" 'monday "7> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 




Figure 5-12 

Deux associations, avec deux valeurs et un neeud par association. 
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Resultat 

dim ( fr ) : dimanche 
dim ( en ) : Sunday 
lun ( fr ) : lundi 
lun ( en ) : monday 

Remarquer ici que la determination du mot se fait non plus par son code, mais par sa 
valeur franchise ou anglaise. 

Deux associations, avec une valeur et deux nceuds par association 

Nousgardons ici lememedictionnaire, mais nouschangeonsa nouveau la declaration de 
cle: 

Declaration de cle 

<xsl:key name="traduction" match="traduction" use="@lang" /> 

Pour chaque element <traduction>, I 'expression -@i ang" ne donne qu'une seule valeur. 
M ais il setrouveque pi usieurs elements ont la meme valeur d'attri but lang ; on va alors 
construire une table dont la structure logique est resumee par la figure 5-13. 




Figure 5-13 

Deux associations, avec une valeur et deux na?uds par association. 
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traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl:key name="traduction" match="traduction" use="@lang" /> 

<xsl :templ ate name="afficher"> 
<xsl:param name="l angue"/> 

<xsl :variable name="traductionsTrouvees" select="key( 'traduction' , $langue)"/> 

<xsl :text> 
</xsl :text> 

<xsl :text>Langue = </xsl :text><xsl :value-of sel ect="$l angueVXxsl :text> : 
</xsl :text> 

<xsl :for-each select="$traductionsTrouvees"> 
<xsl :value-of select=" . "/> 
<xsl:text> ( code : </xsl:text> 
<xsl :value-of select=" . ./@id"/> 
<xsl:text> ) </xsl:text> 
<xsl :text> 
</xsl :text> 

</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="/"> 

<xsl :call-template name="aff i cher"> 

<xsl :with-param name="l angue" sel ect=" ' f r "7> 
</xsl :call-template> 
<xsl : call -tempi ate name="affi cher"> 

<xsl :with-param name="l angue" sel ect=" ' en "7> 
</xsl :call-template> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

Langue = fr : 

dimanche ( code : dim ) 
lundi ( code : lun ) 

Langue = en : 

Sunday ( code : dim ) 
monday ( code : lun ) 



Instruction xshkey 

Chapitre 5 



Construction d'une table a partird'un document XML auxiliaire 

Nous avons deja dit que I'arbreXM L explore lors de la construction de la table est eel ui 
qui contient le nceud contexte, lors de devaluation de I'expression XPath donnant une 
valeur-cle a I 'association. Si ce n'est pas I 'arbre source XML principal, cela peutetre un 
TST lie a une variable, ou un arbre fourni par la fonction document ), qui construit un 
arbre secondai re d'apresun fichierexterneXM L. Danstouslescas, il faut pouvoirchan- 
gerde nceud contexte demaniere a changer d'arbre explore. Oril n'y a qu'uneseule ins- 
truction capable de changer tern porai rem ent le nceud contexte, e'est I 'instruction 
xsi : for-each. Done si I'on veut que la table d'association soit construite a partir d'un 
arbreXML qui n'est pas I 'arbre principal, I'appel a la fonction keyo devra necessaire- 
ment faire partiedu modelede transformation d'une instruction xsi :for-each adequate. 

L'exemple vu a la section Deux associations, avec une valeur et un nceud par associa- 
tion, page 242 pourrait etre repris comme ceci, en supposant que le document principal 

n'aitrien a VOiraveC Dictionnaire.xml : 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 

<xsl :template name="afficher"> 
<xsl:param name="code"/> 

<xsl :for-each sel ect="document( 'Dictionnaire.xml ' )"> 

<xsl variable name="mot" select="key( 'traduction' , $code)"/> 

<xsl :for-each select="$mot/traduction"> 

<xsl :value-of select="$code"/Xxsl :text> ( </xsl:text> 
<xsl :val ue-of select="@lang"/Xxsl :text> ) : </xsl:text> 
<xsl :val ue-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :for-each> 
</xsl :template> 

<xsl :template match="/"> 

<xsl :cal 1 -tempi ate name="afficher"> 

<xsl :with-param name="code" select="'dim"7> 
</xsl :call-template> 
<xsl :call-template name="afficher"> 

<xsl :with-param name="code" sel ect=" ' 1 un "7> 
</xsl : call -tempi ate> 
</xsl :templ ate> 
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<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

dim ( fr ) : dimanche 

dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 

Variante 

II y a une variante possible pour I'appel de la fonction keyo. Elle consiste a transmettre 
comme deuxieme argument un node-set NS au lieu d'une String. Mais ce n'est rien 
d'autre qu'unefacilite syntaxique : cela revient a appeler n fois la fonction keyt ) avec la 
valeur textuelle de chacun des nceuds du node-set N S en deuxieme argument, et a prendre 
comme resultat global, I'union ensembliste de chacun des n node-sets renvoyes separe- 
ment. 



Exemples 

Les exemples classiques, en matiere de manipulation de cles, concernent les references 
croisees (Pattern n° 13 - Generation d 'hyper liens, page 468, Pattern n° 12 - References 
croisees interveners, page459), les regroupements (Pattern n°14 - Regroupements, 
page 474), les constitutions de node-sets d'elements tous differents suivant un certain 
critere (Node-set de valeurs toutes diffe'rentes, page 438). 

M ais rien n'interdit d'utiliser une cle dans des domaines pas du tout classiques : seule 
I 'imagination, en dernier ressort, peut nous limiter. 
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Les instructions de creation 



Les instructions de creation sont celles qui produisentdu textedans I e document resultat, 
sans qu'il s'agisse de texte provenant de la transformation d'elements du source XM L 
traite par le programme X SLT. 

Nous commencerons par instruction <xsi:text>, qui permet de regler Remission 
d'espaces blancs dans le document resultat, et accessoirement, de controler I ' habi 1 1 age 
ou le deshabillage de caracteres speciaux normalement proteges dans leur carapace 
XML. 

Ensuite, nous reviendrons sur I' utilisation d'un element source litteral a contenu calcule 
pour creer du texte XM L dans le document resultat. Nousavionsdeja vu cela (voir Utili- 
sation d'un TST calcul*? (XSLT 1.1 ou plus), page 203), mais ici nous en verrons une 
forme plus evoluee, permettant de parametrer les valeurs de certains attributs, grace a la 
notion dedescripteur de valeur differ <?e d'attribut (Attribute Value Tempi ate). 

Puis nous verrons les instructions X SLT permettant de produire du texte XML (elements 

et attributs) ; Ce SOnt les instructions <xsl :element>, <xsl :attribute>, et <xsl :attri- 

bute-setx Ces instructions peuvent paraitreun peu inutiles, etant donne les possi bi I ites 
offertes par les elements source litteraux, telles qu'on les aura vues. Neanmoins, nous 
verrons qu'il y a des cas ou el les sont indispensables, notamment lorsque les noms des 
balisesXM L qui doivent figurer dans I e document resultat ne sont pas connusau moment 
ou on ecrit le programme. 

Dans le meme ordre d'idee, viendront enfin les instructions permettant de sortir des 
commentaires XML ou des processing-instructions XML ; ce sont les instructions 

<xsl :comment>, et <xsl :processing-instruction>. 
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Instruction xshtext 
Bande-annonce 

L'i instruction <xsi :text> est souvent utilisee pour placer des espaces blancs significatifs 
dans le programme source XSLT. Dans I'exemple ci-dessous, c'est un saut de ligne qui 
est place : 

Nom.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl :template name="insererSautLigneApresTexte"> 

<xsl:param name="texte"/> 

<xsl :value-of select="$texte" /> 

<xsl :text> 
</xsl :text> 

</xsl :templ ate> 

<xsl :template match="Nom"> 

<xsl :call -tempi ate name="insererSautLigneApresTexte"> 
<xsl :with-param name="texte" select="."/> 

</xsl :call-template> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 
Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 
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</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Composi teur>M. Marais</Composi teur> 

<Composi teur>D. Castel 1 o</Compositeur> 

<Compositeur>F. Rognoni</Composi teur> 
</Compositeurs> 

</Concert> 

Resultat 

Jonathan Dunford 
Sylvia Abramowicz 
Benjamin Perrot 

Syntaxe 

xsi :text 

<xsl :text> 

<!-- modele de transformation --> 

... texte brut (pas de texte XML et encore moins XSL) ... 
<!-- fin du modele de transformation --> 
</xsl :text> 

L'i instruction xsi :text ne doit pas apparaitre en tant qu'instruction de premier niveau. 
Semantique 

L'instruction xsi :text ne peut contenir que du texte non balise (done aucune instruction 
XSLT ne peut apparaitre comme enfant d'un element <xsi :text>, ni meme du texte 
XML d'un domaine nominal different de "xsi :"). 

L'instanciation decette instruction consisted recopier le texte de son modele de transfor- 
mation dans le document resultat. II n'y a pas vraiment besoin d'instruction xsi :text 
pour faire ca, puisque e'est le fonctionnement normal de toute instanciation de tout 
modele de transformation : le texte brut qui s'y trouve est recopie dans le document 
resultat. 

M ais l'instruction xsi :text trouve sa raison d'etre lorsqu'elle ne contient que desespaces 
blancs (dans ce cas on est sur que ces espaces blancs seront pris en compte, et recopies 
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dans le document resultat), ou lorsqu'elle contient du texte sans espace blanc (dans ce 
cas, on est sur qu'il n'y aura pas d'espace blanc parasite ajoute au document resultat) : 
s'occuper des espaces blancs, tel est le role (officieux) devolu a cette instruction. 

Exemple 

Nous reprenons ici I'exemple vu a I'occasion de instruction xsi rchoose (voir Instruc- 
tion xskchoose, page 174), dans lequel il y a un probleme de repartition des espaces 
blancs dans le document a produire (I 'exemple se trouve a la section Exemple, page 176). 

Lefichier resultat que I 'on avait obtenu etait lesuivant : 
Resultat 

flute a bee 

Michel Keustermans et Laura Pok 
viole d'amour 

Vinciane Baudhuin 

oboe da caccia 

Blai Justo 

viole de gambe 

Rika Murata , Martin Bauer , Sophie Wati lion 
violone 

Benoit vanden Bemden 

orgue positif et clavecin 

Jacques Willemijns 

On admettra facilement que ce n'est pas totalement satisfaisant, et qu'il serait mieux 
d'avoir quelque chose commececi : 

Resultat 

flute a bee : Michel Keustermans et Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Wati 11 on . 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

M ais avant de voir comment instruction xsi :text va pouvoir intervenir pour resoudre 
le probleme, il faut comprendre ce qui se passe exactement. 

D'une maniere generale, des qu'il y a des problemes d'espaces blancs dans un document 
resultat, les questions a se poser sont les suivantes : 

• Y a-t-il des espaces blancs en trop ? Si oui, proviennent-ils du fichier source XM L ou 
du programme XSLT ? 
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• M anque-t-il des espaces blancs ? Si oui, il faut intervenir sur le programme XSLT (et 
non pas sur le fichier source XML), et dans ce cas, il n'y a rien demieux que ('instruc- 
tion xsl :text. 

S'il y a des espaces blancs en trap, quefaire? Leseliminer, bien sur. 

M ais la facon d'eliminer des espaces blancs en trop n'est pas la meme suivant qu'ils pro- 
viennent du fichier source XM L ou du programme XSLT lui meme : 

• Ceux qui proviennent du fichier source XM L seront broyes par la fonction standard 

normal ize-space() OU par ['instruction <xsl :strip-space>. 

• Quant a ceux qui proviennent du programme XSLT, I ' instruction xsi:text pourra a 
nouveau fai re quelque miracle. 

Note 

instruction <xsl :strip-space> a ete vue a I'occasion de I'instruction <xsl :if> (voir la section Exemple, 
page 170). 

Reste a savoir comment faire pour determiner I'origine d'un espace blanc, que rien ne 
distingue a priori d'un autre. 

Le principe est simple : il faut mettre des marqueurs dans le programme XSLT, et voir 
comment se situent les espaces blancs en trop par rapport aux marqueurs. 

Prenons par exemple les espaces blancs indesi rabies qui se trouvent entre « flute a bee » 
et le caractere « : », et ceux qui se trouvent entre « : » et « M ichel », dans le document 
resultat montre ci-dessus, et essayons de determiner leur origine par des marqueurs. 

L e programme est eel ui -ci (sans changement par rapport a ce qu'on avait a la secti on I ns- 
truction xsl: choose, page 174) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="Rol e"> 

<xsl :value-of sel ect=" . /chi Id: : text( ) "/> : 
<xsl :choose> 

<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl :value-of sel ect=" Interpreted] "/> et <xsl :val ue-of 
sel ect=" Interpreted] "/> 
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</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Le caractere « : » present juste apres I'instruction xsi :vaiue-of constitue deja en lui 
meme un marqueur. Les espaces blancs qui setrouvent entre « flute a bee » et « : » pro- 
viennent done necessairementdu fichier source XM L. On va les supprimer avec un appel 

a normal ize-space( ) '. 

<xsl : val ue-of select="normal ize-space( . /child: :text( )) "/> : 

Cette fonction elimine tous les espaces blancs situes en debut et en fin de la chaine de 
caracteres donnee, et remplace toute sequence interne d'espaces blancs par un seul . Dans 
notre cas, la donnee a traiter se presente comme ceci (oil les « \n » et « \t » designent res- 
pectivement le caractere de fin de ligne et de tabulation) : 

<Role>\n 
\t \t \t \t viole de gambe\n 
\t \t \t \t <Interprete> 

lei, la fonction normal ize-space() va remplacer la Chaine "\n\t\t\t\tviole de gambe\ 
n\t\t\t\t" par "viole de gambe". 

La regie devient celfe-ci : 

<xsl :templ ate match="Role"> 

<xsl :value-of select="normal ize-space( ./child: :text( )) "/> : 
<xsl :choose> 

<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select="Interprete[2]"/> 

</xsl :when> 
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<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :val ue-of sel ect=" . "/Xxsl :if test="not(posiotion( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

Etvoici cequeceladonne: 

R esultat 

flQte a bee : 

Michel Keustermans et Laura Pok viole d'amour : 
Vinciane Baudhuin oboe da caccia : 
Blai Justo viole de gambe : 

Rika Murata, Martin Bauer, Sophie Wati 1 1 on violone : 
Benoit vanden Bemden orgue positif et clavecin : 
Jacques Willemijns 

Tous les espaces blancs situes avant chaque nom d'instrument ont ete supprimes (ce qui 
entraine la perte des sauts de ligne). Reste a voir les espaces blancs qui sont situes apres 
les caracteres 

Placons le marqueur « ! » avant le nom de chaque premier artiste de chaque ligne : 

<xsl : tempi ate match="Rol e"> 

<xsl :val ue-of select="normal ize-space( . /chi Id: : text( ) )"/> : 
<xsl :choose> 

<xsl :when test="count( . /Interprete) = 1 "> 

Kxsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

Kxsl :val ue-of select="Interprete[l]"/> et <xsl :val ue-of 
select=" Interpreter^] "/> 

</xsl :when> 

<xsl :otherwise> 

Kxsl :for-each select="Interprete"> 

<xsl :val ue-of select="."/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 



</xsl :templ ate> 
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Resultat 

flute a bee : 

! Michel Keustermans et Laura Pok viole d'amour : 
! Vinciane Baudhuin oboe da caccia : 
! Blai Justo viole de gambe : 

! Rika Murata, Martin Bauer, Sophie Watillon violone : 
! Benoit vanden Bemden orgue positif et clavecin : 
! Jacques Willemijns 

Clairement, lesespaces blancsen trop sontdans le programme XSLT. C'estvrai toutefois 
que I'espace entre le « ! » et la premiere lettre de chaque ligne provient necessai rement 
du fichier X M L . M ais le gros de la troupe provient du fichier X SLT. 

Par ailleurs, on constate qu'il manque un saut de ligne avant chaque nom d'instrument, 
depuis que nous avons mis en service la fonction normal ize-spaceo, etqu'un nouveau 
saut de ligne est apparu avant chaque « ! » depuis que nous avons place ce marqueur. 

La contre-experience pourrait consister a enlever le marqueur « ! » (qui ne sert plus a 
rien maintenant qu'il aditcequ'il avaitadire), eta en mettreun (parexempleune«* ») 
devant chaque nom d'instrument: 

<xsl :templ ate match="Rol e"> 

*<xsl :value-of select="normalize-space( ./child: :text( ))"/> : 
<xsl :choose> 

<xsl:when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select=" Interpreted] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select=" . "/Xxsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :template> 
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Resultat 

*flute a bee : 
Michel Keustermans et Laura Pok 

*viole d' amour : 
Vinciane Baudhuin 

*oboe da caccia : 
Blai Justo 

*viole de gambe : 

Rika Murata , Martin Bauer , Sophie Watillon 

*violone : 
Benoit vanden Bemden 

*orgue positif et clavecin : 
Jacques Willemijns 

On constate done que la presence du marqueur n'est pas neutre, etqu'elle induit I 'appa- 
rition desautsdelignes. 

Pourquoi ? La feuille de style XSL est un document XM L, ne I'oublions pas. A ce titre, 
el I e est constitute, el I e aussi, de nceuds de type text et d'elements XM L. En particulier 
le debut de la premiere regie sepresenteainsi : 

<xsl : tempi ate match="Rol e">\n 

\n 

\t \t \t *<xsl :val ue-of sel ect="normal ize-space( . /chi Id: : text( ) )"/> :\n 
\t \t \t <xsl :choose> 

Les« \n » et« \t » designenta nouveau lecaracteredefin de I igneetde tabulation. Done, 

entre le nceUd <xsl :template match="Rol e"> et le noeUd <xsl :value-of select="nor- 

maiize-space( ./child: :text( ))"/>, il y a un noeud text, dont la valeur est la chainede 
caracteres "\n\n\t\t\t*". Or leprocesseurXSLT traiteles nceuds text presents dans I es 
model es de remplacement de la maniere suivante : 

• si le noeud text ne contient que des espaces blancs, il est elimine (et n'est done pas 
recopie dans le document resultat) ; 

• mais s'il contient au moins un caractere d'une nature differente (qu'il soit place au 
debut, au milieu ou a la fin), alors il est integralement preserve, et recopie tel quel dans 
I e document resultat. 

La presence ou non dece marqueur « * » change completement I 'allure du resultat final. 

Si on lemaintient, la chainede caracteres "\n\n\t\t\t*" est integralement recopiee dans 
le document resultat; si on le supprime, le noeud text correspondant est elimine, et 
I 'aeration dueaux espaces blancs disparait. 
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L a solution n'est done pas difficile a. obteni r : puisqu'on veut un saut de I igne avant chaque 
nom d'instrument, il suffit de placer un saut de ligne dans une instruction xsi :text. En 
effet, et e'est le propre de cette instruction, meme si le nceud texte qui lui est rattache ne 
contient que des espaces blancs, il n'est pas el i mine. 

<xsl : tempi ate match="Rol e"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of select="normal ize-space( ./child: :text( )) "/> : 
<xsl :choose> 

</xsl :choose> 

</xsl :template> 

Et puisqu'on ne veut pas changer de ligne apres le caractere « : », il suffit de faire 
en sorte que (1°) le saut de ligne qui se trouve juste apres ne fasse pas partie du meme 
nceud texte, (2°) qu'il soit seul (avec eventuellement d'autres espaces blancs) dans 
son nceud texte, et (3°) que tout ce beau monde ne soit pas protege par une instruction 

xsl : text. 

II y a deux solutions : dans la premiere, on inclut le caractere « : » dans une instruction 

xsl : text ! 

<xsl : tempi ate match="Rol e"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of select= 

"normal ize-space( . /chi Id: :text( ) )"/> <xsl:text> : </xsl:text> 
<xsl :choose> 

</xsl :choose> 

</xsl :template> 

Dans la deuxieme, on exclut le saut de ligne du nceud texte contenant le caractere 

« »:« » xsl :text ? 
Note 

L'instruction xsl variable, definissant une variable inutile etinitialisee avec une String vide serait aussi pos- 
sible, dans le sens ou cela donnerait le meme resultat, mais il est evident que ce genre d'astuce stupide n'est 
pas arecommander. 

<xsl : tempi ate match="Rol e"> 



<xsl :text> 
</xsl :text> 

<xsl :value-of select= 
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"normal ize-space( . /chi 1 d: :text( )) "/> : <xsl:text/> 
<xsl :choose> 

</xsl :choose> 



</xsl :templ ate> 

On arrive done final ement a cette solution (dans laquelle on el i mine les espaces blancs 
sur les noms d'interpretes provenant du fichier XML et on ajoute un « . » a la fin de 
chaque ligne, pour completer la ponctuation) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding=' ISO-8859-1 ' /> 



<xsl :template match="Rol e"> 



<xsl :text> 
</xsl :text> 

<xsl :value-of select="normalize-space( ./child: :text())"/> : <xsl:text/> 
<xsl :choose> 



<xsl:when test="count( . /Interprete) = 1 "> 

<xsl : val ue-of sel ect= "normal ize-space( Interprete) "/>. <xsl : text/> 
</xsl :when> 



<xsl:when test="count( . /Interprete) = 2 "> 

<xsl : val ue-of sel ect=" normal ize-space( Interpreted] ) "/> 
<xsl:text> et </xsl:text> 

<xsl : val ue-of sel ect= "normal ize-space( Interpreted] ) "/>.<xsl : text/> 
</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl : val ue-of sel ect=" normal ize-space( . ) "/> 
<xsl:if test="not(position( ) = last())"> 

<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
<xsl :text>.</xsl :text> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 



<xsl :templ ate match="text()"/> 



</xsl :stylesheet> 
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Cequi donne (enfin) le resultat attend u : 
Resultat 

flute a bee : Michel Keustermans et Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Wati 11 on . 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Wi 1 1 emijns . 

Variante syntaxique 

On peut si I'on veut ajouter un attribut disabie-output-escaping, avec la valeur "yes" 
ou "no" ("no" est la valeur par defaut), comme ceci : 



Employee avec I 'attribut disabie-output-escaping, I'instruction xsi :text ne sert plus 
(ou plus seulement) a regler des problemes d'espaces blancs, mais a influencer la facon 
dont certains caracteres (comme "<") devront apparaitre dans le document resultat, lors 
de la serialisation de I'arbre resultat. Par principe, ces caracteres sont pudiquement mas- 
ques d'une feuille de vigne XM L (a ne pas confondre avec une feuille de style XSL), et 
apparaissent done sous forme de references de caracteres (comme "<") ou de refe- 
rences d'entites (comme "&it : "). Si I 'attribut disabie-output-escaping a pour valeur 
« yes », et que le mode de sortie est « html » ou « xml », ils apparaftront alors dans leur 
plus simple appareil (en mode « text », les caracteres sortent toujours « nature » : le pro- 
blemenese pose pas). 




xsl :text 



<xsl :text disabl e-output-escaping=" . . . "> 

... texte brut (pas de texte XML et encore moins XSL) ... 
</xsl :text> 



Semantique 



Exemple 



Dans la version precedents nous rempl aeons la ligne : 



<xsl:text> et </xsl:text> 



par : 



<xsl:text disable-output-escaping="no"> & </xsl:text> 

On obtientceci : 



Resultat 



flute a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
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oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

Commeon estici en mode « text », les caracteres speciaux sortenttels quels, bien qu'on 
n'ait pas invalide la protection. Pour voir reellement ce que §a donne, il faut passer par 
exemple en mode «xml » (ce qui n'a aucun sens dans cet exemple, puisqu'il n'y a 
aucune baliseX M L dans I e document resul tat) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' 

encodings' ISO-8859-1' /> <!-- mode xml active ici !!! --> 

<xsl : tempi ate match="Rol e"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of sel ect="normal ize-space( ./chi 1 d: :text( ) ) "/> : <xsl:text/> 
<xsl :choose> 

<xsl:when test="count( . /Interprete) = 1 "> 

<xsl : val ue-of sel ect=" normal ize-space( Interprete) "/>.<xsl : text/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl : val ue-of sel ect= "normal ize-space( Interpreted] ) "/> 

<xsl:text disable-output-escaping="no"> & </xsl:text> 

<xsl : val ue-of sel ect=" normal ize-space( Interpreted] ) "/>.<xsl : text/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl : val ue-of sel ect=" normal ize-space( . ) "/> 
<xsl:if test="not(position( ) = last())"> 

<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
<xsl :text>.</xsl :text> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl :template match="text( )"/> 



</xsl :stylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
flOte a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Wati 11 on . 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Wi 1 1 emi jns . 

M aintenant, nous basculons la valeur de I'attri but disabie-output-escaping : 

<xsl:text disable-output-escaping="yes"> & </xsl:text> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
flute a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Wati lion. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Wi 1 1 emi jns . 



Creation de texte XML par un element source litteral 

Nous al Ions ici reuti User une technique deja vue (voir Utilisation d'un TST calcule 
(XSLT 1.1 ou plus), page 203), qui consiste a cabler dans un element source litteral a 
contenu calcule, la structure XML que I'on veut obtenir : 

<xsl :templ ate match="Concert"> 

<xsl :variable name="mouvement"> 
<insert> 

<Ensembl e> 

<NomXxsl :value-of sel ect="NomEnsembl e"/X/Nom> 

<Di recti onXxsl : val ue-of sel ect=" Chef "/X/Di recti on> 

</Ensemble> 

<Concert> 

<DateXxsl :value-of sel ect="Date"/X/Date> 
<VilleXxsl :value-of select="Ville"/X/Ville> 
<LieuXxsl :value-of sel ect="Sal 1 e"/X/Lieu> 
<Ti treXxsl : val ue-of sel ect="TitreConcert"/X/Titre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :templ ate> 

Une fois instancie, I'element source litteral <insert> donne un TST (Temporary Source 
Tree) dont la serialisation produit ceci dans le document resultat : 
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instantiation de ce modele 

<insert> 

<Ensembl e> 

<Nom>. . .</Nom> 

<Di recti on>. . .</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>. . .</Date> 

<Ville>. . .</Ville> 

<Lieu>. . .</Lieu> 

<Titre>. . .X/Titre> 
</Concert> 
</insert> 

On a done ici non pas une simple transformation d'un arbre source existant, mais bien 
une creation de fragment d'arbre entierement nouveau. 

Remarquez toutefois qu'on est dans un cas simple, ou seuls les contenus textuels des 
elements sont susceptibles de varier ; mais on peut se demander ce qui se passerait si 
certains elements devaienteux-memesdependrede la source XM L atraiter. 

II y a plusieurs degres de variabilis pour un element : 

• lenom d'un attri but ou d'un element dependede la source X M L, mais les valeurs pos- 
sibles sont a choi sir parmi n valeurs connues au moment d'ecrire le programme ; 

• la valeur d'un attri but depend de la source XM L ; 

• le nom d'un attri but ou d'un element depende de la source XM L sans restriction. 

Seuls les deux premiers cas sont a la portee de la technique de I 'element source litteral a 
contenu calcule; le troisieme necessite I'emploi des instructions <xsi :eiement> ou 
<xsi :atn'but>, que I'on verra plus bas. 

Le premier cas ne met rien de nouveau en oeuvre ; il suffit de combiner I'emploi a" ele- 
ments source litteraux et d'instructions <xsi :choose>. 

Le deuxieme est plus coriace, comme nous al Ions maintenant nous en rendre compte. 

L'exemple choisi est assez classique, e'est la fusion de sources XM L. La fusion de deux 
documents XML, par exemple, consiste a en produire un troisieme, constituant d'une 
maniere ou d'une autre une synthese des deux autres. 

II s'agira ici de creer un document XM L, dont la structure sera fournie par un element 
source litteral a contenu calcule, exactement comme dans l'exemple ci-dessus; le 
contenu des elements sera preleve dans I'un des deux documents XM L, et la valeur des 
attri buts de ces elements sera prelevee dans I'autre. 

Exemple 

Nous allons supposer que nous devons preparer un document de travail pour un recitant 
qui aura a dedamer un texte pendant I 'execution d'une certaine piece pendant un concert. 
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Les documents de base sont d'une part le texte de la declamation (fichier deciamation- 
Taiiie.xmi) et d'autre part la liste des numeros de mesure ou doivent se situer les inter- 
ventions du reCitant (fichier synopsisRecitant.xml) : 



Note 

Ce texte a ete ecrit par Marin Marais (probablement un douloureux souvenir personnel, I'operation de la taille 
etant une extraction de calculs de la vessie, avec une priere en guise d'anesthesie) pour accompagner I'une de 
ses pieces de viole, publiee apres sa mort Sa veuve avait censure ce texte en le supprimantde la gravure off i- 
cielle (actuellement encore disponible en fac-simile), mais des copies ontcircule, et I'une d'entre elles nous est 
parvenue. La graphie en est curieuse, mais elle n'avait rien d'extraordinaire a une epoque ou I'orthographe 
(notion d'ailleurs totalement anachronique, on parlait plutot de grammaire) se reduisait en gros aux regies 
d'accord, eta des regies d'usage tres liberates, autorisantde nombreuses variations laissees au libre arbitre du 
scripteur. 

deel amati onTa i 1 1 e . xml 

<?xml version="1.0" encoding="UTF-16"?> 
<texte> 

<reference> 

Pieces de viole du 5 - livre, 1725 

Marin Marais 
</reference> 



<titre> 

Le Tableau de 1 'Operation de la Taille 
</titre> 

<paroles> 

<p>L'aspect de l'apareil .</p> 

<p>Fremissement en le voyant.</p> 

<p>Resolution pour y monter.</p> 

<p>Parvenu jusqu'au hault;</p> 

<p>descente dudit apareil.</p> 

<p>Reflexions serieuses.</p> 

<p>Entrel assement des soyes 

Entre les bras et les jambes . </p> 

<p>Icy se fait 1 'incision. </p> 

<p>Introduction de la tenette.</p> 

<p>Ici l'on tire la piere.</p> 

<p>Icy l'on perd quasi la voix.</p> 

<p>Ecoul ement du sang.</p> 

<p>Icy l'on oste les soyes. </p> 

<p>Icy l'on vous transporte dans le lit.</p> 
</parol es> 



</texte> 
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synopsisRecitant.xml 

<?xml version="1.0" 
<synopsi sRecitant> 



encoding="UTF-16"?> 



<prol ogue/> 



<Numeros> 

<NoMesure>K/NoMesure> 

<NoMesure>8</NoMesure> 

<NoMesure>ll</NoMesure> 

<NoMesure>15</NoMesure> 

<NoMesure>20</NoMesure> 

<NoMesure>22</NoMesure> 

<NoMesure>23</NoMesure> 

<NoMesure>27</NoMesure> 

<NoMesure>3K/NoMesure> 

<NoMesure>39</NoMesure> 

<NoMesure>44</NoMesure> 

<NoMesure>48</NoMesure> 

<NoMesure>50</NoMesure> 

<NoMesure>53</NoMesure> 

</Numeros> 



</synopsisRecitant> 

On veut obtenir un document XM L qui donne le textede la declamation, avec les nume- 
ros de mesure associes, comme ceci : 

synopsisRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 
<mesure No="8">Freini ssement en le voyant.</mesure> 
<mesure No="ll">Resol ution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27">Icy se fait 1 ' incision. </mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici l'on tire la piere.</mesure> 
<mesure No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50">Icy l'on oste les soyes. </mesure> 
<mesure No="53">Icy l'on vous transporte dans le lit.</mesure> 
</recitant> 
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On va done comme prevu utiliser la technique de I 'element source I itteral a contenu cal- 
cule. II estici parti culierement simple, etant la structure extremement plate du document 
a produire : 

Element source 1 itteral a contenu calcule 

<mesure No=" . . . "> 

</mesure> 

II n'y a que deux valeurs calculees a placer dans I'element source I itteral : le numero de 
mesure, et le texte a declamer. 

L a feuille de style devant manipuler deux sources XM L, on vadonc proceder dela meme 
facon que dans I'exemplevu a la section Exemple, page 223, ou il s'agissaitdefairedela 
traduction d'apres un dictionnaire : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding='IS0-8859-l' /> 
<xsl:param name="declamationFileRef" select=" 'deel amationTai 1 1 e.xml ' " /> 
<xsl :variable name="declamation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl :templ ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 

<xsl :templ ate match="prologue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl :template> 

<xsl :templ ate match="Numeros"> 
</xsl :templ ate> 

<xsl :templ ate match="text( ) "/> 
</xsl :stylesheet> 

La source principale est le fichier synopsisRecntant.xmi, et la source secondaire le 
richer deci amationTai n e.xmi . Cechoix est bien sflr arbitraire, mais comme la structure 
du document a produire est tres proche de la structure du document donnant le synopsis 
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du recitant, il estevidemmentplusfaciledepartirdu fichier synopsisRecitant.xmi que 

du ficher decl amati onTai 1 1 e .xml . 

Le texte de la declamation sera done accessible au travers de la variable deci amati on, qui 
en I'occurrence est un node-set de trois elements, les trois elements rattaches a la racine 

<texte> du document XM L, a SaVOir : <reference>, <titre>, et <paroles>. 

Le noeud du probleme, ici, est devoir comment remplir I 'element source litteral : 

<mesure No=" . . . "> 
</mesure> 

Comme il y a plusieurs numeros de mesure a traiter, tous sur le meme modele, nous 
aurons done une instruction <xsi : for-each> : 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<mesure No=" ... (1) ... "> 

...(2)... 
</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

Le texte qui doit apparaitre en (2) est a determiner en fonction de la position du 
<NoMesure> courant a I'interieur de instruction <xsi :for-each> : si par exemple 
I'element <NoMesure> en cours est le quatrieme fils de I'element <Numeros>, dans 
I'ordre de lecture du document, alors il faut aller chercher le quatrieme fils de I'element 
<paroies> dans ledocument contenantla declamation. Cela n'estpasdu toutcomplique 
a faire: il suffit de sauvegarder dans une variable la position courante (e'est-a-dire la 
valeur4, dans notre exemple), et d'utiliser cette valeur dans un predicat: 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No=" ... (1) ... "> 

<xsl :val ue-of sel ect= " $decl amati on/pa roles /p[positi on ( )=$i]"/> 
</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

On sel ectionne tous les elements <p> enfantsde <paroies>, eton filtre en ne retenantque 
celui dontla position est precisementegale a $i. 

II n'y a plus qu'a renseigner la valeur de I'attribut (marquee « ...(1)... » ci-dessus). M ais 
avant de voir comment faire cela, il n'est pas ininteressant de tenter la petite experience 
suivante : on va placer en (1) une expression X Path quelconque, n'importe laquelle, juste 
pour voir ce que le processeur X SLT va en faire. 
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M essaged'erreur ? Evaluation ? Superbe indifference ? Suspens... 

On choisit I'expression que I'on vient d'analyser; c'est bien sfir completement idiot, 
mais voyons tout de meme : 

<xsl :templ ate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No="$declamation/paroles/p[position( ) = $i]"> 

<xsl :val ue-of sel ect="$decl amati on/parol es/p[posi ti on( ) = $i]"/> 
</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

On lance le processeur X SLT, et voici ce qu'on obtient : 

i nterventi onReci tant . xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prologue> 

<mesure No="$declamation/paroles/p[position( ) = $i]">L'aspect de l'apareil. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">Fremissement en le voyant. 
</mesure> 

<mesure No="$declamation/paroles/p[position() = $i ]">Resol ution pour y monter. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Parvenu jusqu'au haul t ; 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">descente dudit apareil. 
</mesure> 

<mesure No="$declamation/paroles/p[position() = $i ]">Reflexions serieuses. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Entrelassement des soyes 

Entre les bras et les jambes . </mesure> 
<mesure No="$declamation/paroles/p[position( ) = $i]">Icy se fait 1 'incision. 
</mesure> 

<mesure No="$declamation/paroles/p[position() = $i ]">Introduction de la tenette. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Ici I'on tire la piere. 
</mesure> 

<mesure No="$declamation/paroles/p[position() = $i]">Icy I'on perd quasi la voix. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Ecoulement du sang.</mesure> 
<mesure No="$declamation/paroles/p[position( ) = $i]">Icy I'on oste les soyes. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Icy I'on vous transporte 
dans le 1 it.</mesure> 
</recitant> 
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Le resultat est assez eloquent. Pas de message d'erreur, pas devaluation : la valeur 
d'attri but est prise pour du texte ordinal re, restituetel quel dans le document resultat. 

Cela ruine completement I'espoir qu'on avait de produire les bons numeros de mesure, 
puisqu'apparemment, quelqu'expression que I'on puisse ecrire, el I e sera prise pour du 
texte a recopier. 

Completement ? Pas tout a fait ; le cas a ete prevu. 

La solution est d'utiliser ici ce qu'on appelle un descripteur de valeur differ <?e d'attri but, 
ou Attribute Value Template (denomination du standard XSLT). Le mot template, ici, 
n'est pas le bienvenu ; il est deja surabondamment util ise en X SLT, et dans le cas present, 
son utilisation ne s'imposait vraiment pas, car un attribute value template n'a rien a voir 
avec une regie (template rule) ni un modele de transformation (template, suivant la 
denomination standard XSLT). 



Descripteur de valeur differee d'attribut (Attribute Value Template) 

Un descripteur de valeur differee d'attribut, ce n'est pas une valeur d'attribut, mais c'est 
quelque chose qui de'crit une valeur d'attribut. La valeur n'est done pas fournie directe- 
mentetlitteralement, el I e est seulementdecriteet par consequent differee : il fauten effet 
attendre I'execution du processeur XSLT, qui va interpreter cette description, pour en 
tirer une valeur exploitable. 

Notez qu'il n'y a rien d'extraordinaire dans tout cela ; a chaquefois qu'on fournit I 'attri- 
but select d'une instruction xsi : vaiue-of, comme par exemple : 

select="$declamation/paroles/p[position() = $i] n 

on est dans la meme situation : la valeur de I ' attri but n'est pas fournie I itteralement, mais 
sous forme d'un descripteur, qui est ici une expression X Path. Cette expression decritune 
valeur differee, puisqu'il faut attendre I'execution du processeur XSLT pour que deva- 
luation ait lieu. 

Mors dans ces conditions, pourquoi inventer une denomination speciale si la chose est 
dej a connue, nommee, et courante ? 

Eh bien, pour la raison qu'on vient devoir. Si I'on emploie une expression X Path comme 
valeur d'attribut select, c'est parfait, puisquejustement, on est censefournir une expres- 
sion XPath pour un attri but select. Par contre, ce n'est pas parfait du tout pour un attri - 
but inconnu intervenant inopinement dans un element inconnu du processeur XSLT, 
comme peuvent I'etre I'element <mesure> et I ' attri but No. Le processeur n'ayant aucune 
connaissancesur les <mesure>, les No, ni toutes ces sortes de choses, il nepeut pas savoir 
si la valeur d'attribut qu'on fournit est une valeur litterale, ou une valeur a interpreter. 

II faut done le lui dire. Si on ne dit rien de special, la valeur fournie est litterale ; si on 
agite le chiffon rouge, le processeur est prevenu que la valeur fournie n'est pas litterale, 
mais que c'est une expression XPath aevaluer. 
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Le chiffon rouge en question, c'est une paire d'accolades : {abed} estun descripteur de 
valeur differee d'attribut, indiquant que la chaine de caracteres « abed » est une expres- 
sion X Path a interpreter comme telle. Commed'habitudeen pareil cas, il fauttrouver une 
astuce pour pouvoir eventuellement fournir une valeur litterale, qui malheureusement, 
seraitdela forme {abed} ; pour annuler l'effet« chiffon rouge » deces accolades, on les 
redouble, comme ceci : {{abed}}. 

Un descripteur de valeur differee d'attribut est done evalue en tantqu'expression XPath, 
et le resultat obtenu est converti en String, comme si la fonction standard stringo eta it 
explicitementappelee. 

Remarque 

II ne suffit pas de demanderpouretre servi : les endroits oil le langage XSLT autorise Pemploi de descripteurde 
valeur differee d'attribut sont assez peu nombreux (et meme plutot rares) dans I'ensemble. lis sont repertories 
en annexe (voir Regies syntaxiques, page 625). 

Notez qu'un descripteur de valeur differee d'attribut ne constitue pas necessairement la 
total ite de la valeur d'attribut: on peut tres bien ecrire une expression du genre 
"xy{abcd}zt" ; a I 'execution, la valeur d'attribut sera egale a la chaine litterale xy, suivie 
d'une String resultat de devaluation de I 'expression XPath abed, suivie de la chaine litte- 
rale zt. 

Suite de I'exemple 

II ne nous reste plus qu'a utiliser cette notion de descripteur de valeur differee d'attribut 
pour terminer I'exemple que nous avions commence ci-dessus. 

N ous etions arrives a ce point : 

<xsl : tempi ate match="Numeros"> 

<xs1 :for-each select="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No=" . . . ( 1 ) . . . "> 

<xsl :val ue-of sel ect="$decl amati on/parol es/p[posi ti on( ) = $i]"/> 
</mesure> 
</xsl : for-each> 
</xsl :templ ate> 

Le probleme est maintenant de renseigner la valeur de I 'attri but No. Au point (1), I'ele- 
ment courant est un certain <NoMesure>. La valeur a placer dans I 'attri but No est done la 
valeur textuelle de I 'element <NoMesure> courant. L expression XPath qui designe le 
nceud courant se reduisant simplementa« . », le descripteurde valeur differee d'attribut 
a utiliser sera done simplement ■{.}". On arrive done a cette version du programme : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 
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xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 



<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declainationFileRef " sel ect=" 'decl amationTai 1 le.xml' " /> 
<xsl :variable name="declamation" 

sel ect="document( SdeclamationFileRef )/texte" /> 



<xsl : tempi ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 



<xsl :template match="prol ogue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl :template> 



<xsl :template match="Numeros"> 
<xsl :for-each select="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No="{ . } "> 

<xsl :val ue-of select="$declamation/paroles/p[position() = $i]"/> 
</mesure> 
</xsl :for-each> 
</xsl :template> 



<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Et le resultat obtenu est bien celui qu'on attendait : 

interventionRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prologue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 
<mesure No="8">Fremi ssement en le voyant.</mesure> 
<mesure No="ll">Resol ution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27">Icy se fait 1 'incision. </mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici l'on tire la piere.</mesure> 
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<mesure No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50">Icy l'on oste les soyes.</mesure> 
<mesure No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

Conclusion 

Avec les notions d'element source litteral a contenu calcule et de descripteur de valeur 
differee d'attri but, on a deja une certaine souplesse pour creer des documents XML; 
mais, ainsi que nous I'avons vu plus haut, certaines possibility restent hors d'atteinte. 
Pour aller plus loin, il faut pouvoir creer de nouveaux elements (ou de nouveaux attri- 
buts) dont le nom est obtenu comme le resultat de I 'evaluation d' une expression XPath. 

C 'est ce que nous al I ons voi r mai ntenant. 

Instruction xshelement 

Bande-annonce 

Cette instruction permet de creer des elements XML dans le document resultat. U n frag- 
ment de programme comme celui-ci : 

<Ensembl e> 
<Nom> 

<xsl :value-of select="NoinEnsenible' , /> 
</Nom> 
<Di recti on> 

<xsl :value-of select="Chef "/> 
</Di rection> 
</Ensembl e> 

peut etre remplace par ceci : 

<xsl : el ement name="Ensembl e"> 
<xsl:element name="Nom"> 

<xsl :value-of select="NomEnsemble"/> 
</xsl :element> 

<xsl:element name="Di rection"> 

<xsl :value-of select="Chef "/> 
</xsl :element> 
</xsl :el ement> 

L'avantage est que I 'attri but name accepte les descripteurs de valeurs differees d'attri but, 
cequi permet decalculer lenom del'element, au lieu qu'il faille lecabler en durdans le 
programme : 

<xsl : el ement name="{$x}"> 



</xsl :el ement> 
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Syntaxe 

xsl :el ement 

<xsl: element name="..."> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :element> 

L'instruction xsi: element ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Semantique 

L'instruction <xsl :element name="xxx"> ... </xsl : el ement> produit dans le docu- 
ment resultat un element XM L dela forme <xxx> . . . </xxx>, dont le nom estfourni par 
I'attribut name, et dont le contenu est le resultat de I'instanciation du modele de transfor- 
mation associe. 

Exemple trivial 

Le premier exemple sera une simple mise en parallele de la creation d'un document 
XML par la technique de I 'element source litteral a contenu calcule, et par eel le de l'ins- 
truction xsl : el ement. 

Pour cela, nous reprenons I 'exemple vu a la section Utilisation d'un TST calcule (XSLT 
1.1 ou plus), page 203. Nous avions mis au point ce programme XSLT (la presentation 
est legerement modifiee pour faciliter la comparaison) : 

preparelnsert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl :template match="/"> 

<Mouvements> 

<xsl :apply-templates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl :template match="Concert"> 

<xsl :variable name="mouveinent"> 
<insert> 

<Ensembl e> 
<Nom> 

<xsl :value-of select="NomEnsemble"/> 
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</Nom> 

<Di recti on> 

<xsl :value-of select="Chef "/> 

</Direction> 
</Ensemble> 
<Concert> 

<Date> 

<xsl :value-of select="Date"/> 
</Date> 
<Ville> 

<xsl :value-of select="Ville"/> 

</vnie> 

<Lieu> 

<xsl :value-of select="Salle"/> 
</Lieu> 
<Titre> 

<xsl :value-of select="TitreConcert"/> 
</Titre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

On a ici la creation d'un document XML cable dans le programme X SLT sous la forme 
d'un element source litteral a contenu calcule. On va done voir comment faire la meme 

Chose avec I 'instruction xsl : element. 

La modification est assez triviale: dans la regie <xsi: tempi ate match="Concert"> il 
suffit de remplacer chaque balise litterale (hors du domaine nominal d'XSLT) par une 
instruction xsi :eiement, comme ceci : 

<xsl : tempi ate match="Concert"> 

<xsl :variable name="mouvement"> 
<xsl:element name="insert"> 

<xsl:element name="Ensembl e"> 
<xsl:element name="Nom"> 

<xsl :value-of select="NomEnsemble"/> 
</xsl :element> 

<xsl:element name="Di rection"> 

<xsl :value-of select="Chef "/> 
</xsl :element> 
</xsl :element> 

<xsl:element name="Concert"> 
<xsl:element name="Date"> 

<xsl :value-of select="Date"/> 
</xsl :element> 
<xsl:element name="Ville"> 
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<xsl :value-of select="Ville"/> 
</xsl :el ement> 
<xsl:element name="Lieu"> 

<xsl : val ue-of select="Salle"/> 
</xsl :el ement> 
<xsl:element name="Titre"> 

<xsl :value-of select="TitreConcert"/> 
</xsl :el ement> 
</xsl :element> 
</xsl :el ement> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :templ ate> 

Cette regie est I 'equivalent de eel le montree dans le programme ci-dessus, et bien sfir, a 
I'execution, le resultat obtenu est strictement identique dans ledeux cas. 

Mais clairement, ici, instruction xsi :eiement n'apporte rien du tout, et rend meme le 
programme plus difficile a lire, en lui donnant une apparence plus confuse. 

Exemple plus evolue 

Nous allons ici revoir un exemple du meme genre que celui vu a la section Exemple, 
page 263 : un probleme de fusion de documents XML. M ais la difference avec le cas 
assez simple que nous avionsvu, est que cette fois, lenom des elements a produi re dans 
le document resultat est calcule lors du processus de fusion ; la technique de I'element 
source I itteral ne sera done pas uti Usable. 

Le contexte est celui d'une application serveur, construite autour de technologies a 
objets, qui doit d'une part, presenter a un client leger (navigateur Web) emetteur de 
requetes, des donnees prelevees dans une base relationnelle et d'autre part, assurer la 
mise a jour en temps reel de cette base, en fonction des requetes emises. L 'application est 
architecture autour d'un referentiel metier, e'est-a-dire un ensemble de classes modeli- 
sant les entites et les relations issues d'une analyse semantique du metier sous-jacent. 
L'un des problemes classiques a resoudre est ce qu'on appelle le « mapping », dans le 
jargon consacre, e'est-a-dire la mise en correspondance d'une classeet d'une table, dans 
lecas le plus simple (les cas plus complexes sont ceux ou les attributs d'un objet corres- 
pondent a des colonnes reparties dans plusieurs table). Cette mise en correspondance 
consiste tout simplement a recuperer les bonnes colonnes dans la bonne table pour char- 
ger un objet, ou inversement, de mettre a jour les bonnes colonnes de la bonne table a 
partir des attributs d'un objet. 

II y a pi usieursf aeons de realiser les mappings necessai res a I 'application ; I'uned'entre 
elles, qui n'est pas la moins mauvaise, consiste a ecri re un generateur decode capable de 
produi re automatiquement les classes (en Java, par exemple) qui vont realiser I 'interface 
entre les objets metier et la base de donnees. U n tel generateur de code va s'appuyer sur 
un fichier de mapping, qui pourrait avoir I'alluresuivante : 
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mapping .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 

<ACC0RD> 
<DEDEC> 

<f i el d>begi nni ng_date</f i el d> 

<type>BusinessDate</type> 
</DEDEC> 
<CCETF> 

<field>state</field> 

<type>Stri ng</type> 
</CCETF> 
<N0ACA> 

<f i el d>company_i d</f i el d> 

<type>Stri ng</type> 
</N0ACA> 
<N0POA> 

<f i el d>contract_nbr</f i el d> 

<type>Stri ng</type> 
</N0P0A> 
<CCPAA1> 

<f iel d>country_code</f ield> 

<type>Integer</type> 
</CCPAAl> 
</ACC0RD> 

<table>COMPANY</table> 
<C0MPANY> 
<N0ACA> 

<field>company_id</field> 

<type>Stri ng</type> 
</N0ACA> 
<LSACA1> 

<f i el d>company_name</f iel d> 

<type>Stri ng</type> 
</LSACAl> 
<CCPAA1> 

<f i el d>country_code</f iel d> 

<type>Integer</type> 
</CCPAAl> 
<LAACA1> 

<field>address</field> 

<type>Stri ng</type> 
</LAACAl> 
<URL> 

<field>URL</field> 

<type>Stri ng</type> 
</URL> 
<STATRAT> 

<field>qual ity_code</field> 
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<type>String</type> 
</STATRAT> 
</C0MPANY> 
</mapping> 

dedec, ccetf, noaca, etc. represented des noms de colonnes qui sont mis en correspon- 
dence avec des noms d'attri buts (<f iei d>) et des types J ava (<type>). 

Ce genre de fichier, pour une petite application, pourrait etre constitue a la main ; mais 
pour une application qui doit se connecter a une base existante comportant une centaine 
de tables de dix a soixante colonnes dont les noms sont pour la plupart i mprononcables et 
difficiles a memoriser, il est clairqu'un travail a la main n'estpas adequat. 

L'administrateur de la base de donnees, mis a contribution, nous a fourni un fichier par 
table, ayant la structure suivante : 

accord.xml 

<?xml version="1.0" encoding="UTF-16"?> 

<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6Xbr/> 

N0P0A<tab/>VARCHAR2(35Xbr7> 

CCPAAKtab/>NUMBER(4Xbr/> 

</table> 

company .xml 

<?xm1 version="1.0" encoding="UTF-16" ?> 

<table name="COMPANY"> 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2(l)<br/> 

</table> 

L a structure de ces fichiers n'est pas extraordinaire, mais ilscontiennent les informations 
dont on a besoin (le nom des colonnes et le type SQL utilise) ; il faudra done faire avec. 
M ais bien sur, ce que ces fichiers ne donnent pas, e'est la correspondance des noms de 
colonnes et des noms d'attri buts. Ce fichier de correspondance ne peut pas etre genere, 
il faut le constituer a la main ; mais e'est moins penible que d'etablir a la main le fichier 
de mapping, car les memes noms de colonnes reviennent assez souvent dans des tables 
differentes. 

fields .xml 

<?xml version="1.0" encoding="UTF-16"?> 
<fields> 

<field id="DEDEC" >beginning_date</field> 
<field id="CCETF" >state </field> 
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<field i d=" NOACA" >company_id 



</field> 
</field> 
</field> 
</field> 
</field> 
</field> 
</field> 



<field id="N0P0A" >contract_nbr 

<field id="CCPAAl" >country_code 

<field i d=" LSACA1" >company_name 

<field i d=" LAACA1 " >address 



<field id="URL" >URL 



<field id="STATRAT">quality_code 



</fields> 



Leprobleme est done maintenant pose : en partant des fichiers accord .xml , company .xml 
et fields. xmi, il s'agit de produire lefichier mapping.xmi. 

M ais, comme nous I'avons dit, il peut y avoir plusieurs dizaines de tables ; or il neserait 
pas raisonnable d'avoir plusieurs dizaines de sources XML pour le programme XSLT. 
Nous al Ions done commencer par reunir toutes les sources de description de tables en une 
seule, en utilisant des appels d'entites XML externes, comme ceci : 

tables .xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<!D0CTYPE tables [ 

<! ENTITY accord SYSTEM ' accord .xml' > 
< ! ENTITY company SYSTEM 'company. xml '> 
]> 

<tables> 
&accord; 
^company ; 
</tables> 

L e fichier XML tables, xmi est equivalent a un fichier unique : 

<?xml version="1.0" encoding="UTF-16" ?> 
<tables> 

<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6Xbr/> 

N0P0A<tab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

</table> 

<table name^COMPANY^ 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2(l)<br/> 

</table> 



</tables> 
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Nous allons maintenant proceder en deux etapes. 
Premiere etape 

La premiere etape consiste a trouver comment recuperer les informations pertinentes 
dans le fichier XML tables. xmi , dont la structure est bizarre, calquee sur une structure 
de fichier d'export de schema de base, mais pas du tout dans le style X M L . 

Le probleme est done de savoir comment, a parti r du fichier tables. xmi, on pourrait 
obtenir le fichier suivant : 



table ACCORD : 










nom 


de 


col onne 




DEDEC; 


type = 


DATE 


nom 


de 


col onne 




CCETF; 


type = 


CHAR(l) 


nom 


de 


col onne 




NOACA; 


type = 


CHAR(6) 


nom 


de 


col onne 




NOPOA; 


type = 


VARCHAR2(35) 


nom 


de 


col onne 




CCPAA1; 


type 


= NUMBER(4) 


table 


COMPANY 










nom 


de 


col onne 




NOACA; 


type = 


CHAR(6) 


nom 


de 


col onne 




LSACA1; 


type 


= VARCHAR2(35 


nom 


de 


col onne 




CCPAA1; 


type 


= NUMBERC4) 


nom 


de 


col onne 




LAACA1 ; 


type 


= VARCHAR2(35 


nom 


de 


col onne 




URL; type = VARCHAR2(40) 


nom 


de 


col onne 




STATRAT; type 


= VARCHAR2Q 



Pour chaque table, il y a une succession d'elements <tab/> ; et pour chaque element 
<tab/>, lenom de colonne est le premier nceud detype text, si tue juste avant I 'element 
<tab/> courant (e'est le nceud en premiere position sur I'axe preceding-si bi ing), et le 
nom de type SQL est le premier nceud de type text, situe juste apres I 'element <tab/> 
courant (e'est le nceud en premiere position sur I 'axe f oi 1 owi ng-si bi i ng). 

Le programme XSLT qui produit le document resultat montre ci-dessus decoule directe- 
ment de cette remarque : 

essai .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmi ns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl :template match="tabl e"> 

<xsl :text/>tabl e <xsl :val ue-of sel ect="@name"/> :<xsl:text> 
</xsl :text> 

<xsl :for-each select="tab"> 

<xsl :text>nom de colonne = </xsl:text> 
<xsl :value-of sel ect="normal ize-space( 

precedi ng-si bl ing: :text( )[1] )"/> 
<xsl:text>; type = </xsl:text> 
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<xsl :value-of sel ect="normal i ze-space( 

following-sibling: : text( ) [1] ) "/> 

<xsl :text> 

</xsl :text> 

</xsl :for-each> 

</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Deuxieme etape 

II s'agit maintenant de faire la synthese entre la premiere source XML, representee par 
lefichier tables. xmi, et la deuxieme, qui donne la correspondance entre les noms deco- 
lonnes et les noms d'attri buts. Ce probleme ressemblefortement au probleme de traduc- 
tion que nous avions vu a la section Exemple, page 223. Nous pourrons done reprendre 
les elements real isant une traduction, que nous avions mis au point a cette occasion, et 
les adapter a notre probleme actuel. 

II y a aussi unecertaineressemblanceavec ce que nous avonsvu a la section precedence 
(voir Exemple trivial, page 273), puisqu'il va etre question de creer des elements dans le 
document resultat. M ais la ressemblance n'est pas complete, car ici nous allons devoir 
creer des elements (comme <noaca> ) dont lenom nepeut pas etre mis « en dur » dans le 
programme. 

L'instruction qui fait cela est toujours instruction <xsi :eiement>, et a supposer que le 
nom del 'element agenerer soitcontenu dans une variable eiementName, la premiere idee 
qui pourrait venir a I 'esprit serait d'ecrire quelque chose comme : 

<xsl :element name="$el ementName"> 

M ais on tombe sur le probleme deja analyse a la section Descripteur de valeur differ ee 
d'attri but (Attribute Value Template), page 269 : a I 'execution, soit on va obtenir ceci : 

<$el ementName> 

<field>. . .</field> 

<type>. . .</type> 
</$el ementName> 

alors qu'on attend : 

<DEDEC> 

<field>. . .</field> 

<type>. . .</type> 
</DEDEC> 

soit on va obtenir un message d'erreur du processeurXSLT, degoute d'avoir failli mordre 
dans une baliseX M L pleine d'asticots (<$eiementName>), aenjuger parcelui qui setor- 
tilleau debut. 
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La solution est la meme que precedemment, il faut utiliser un descripteur de valeur diffe- 
red 'attri but. 



Attention 

Use trouveque nous sommes dans un cas, avec Instruction <xsl :element>,ou un descripteur de valeur diffe- 
red d'attribut est autorise pour I'attribut name, Mais nous avons deja. signale que ce n'etait pas une construction 
toujours possible. 

Les descripteurs de valeurdifferee d'attribut sont, il estvrai, toujours autorises etreconnus avec un elementXML 
faisantpartie d'un elementsource litteral, mais c'esttoutle contraire avec les attributs des elements XSLT (c'est- 
a-dire des instructions XSLT) : ils sonttres rarementacceptes ou reconnus. 

M ais I 'instruction <xsi :eiement> fait partiedes heureuseselues, etca tombe bien, parce 
que sinon, il n'y avait plus qu'a mettre la de sous la porte : ce qu'on voulait faire aurait 
ete impossible. 

Note 

Tiens, tiens ? Le langage XSLT n'auraitdonc plus eteTuring-completacause dece detail stupide ? II y aurait eu 
des choses impossibles a programmer? Non, rassurez vous, cela n'aurait rien change au caractere Turing- 
complet du langage. En fait on peut se passer de descripteur de valeur differee d'attribut : il suffit de ne pas 
vouloir generer du texte XML, mais du texte ordinaire, quitte a sortir « a la main » tous les caracteres speciaux 
comme « <» ou « > ». Mais cela seraitde beaucoup plus bas niveau, beaucoup plus complique a lire, etpropice 
auxerreurs. En effetunTST ne peut pas etre mal structure ;c'estnecessairementun arbre avec une vraie forme 
de vrai arbre, pas un eclope genetiquement modifie : si on bricole soi meme les boutures en contournant les 
regies lexicales de XML, on peut faire beaucoup d'erreurs sans etre jamais averti parle parseurXML associeau 
processeurXSLT. 

Toujours est-il qu'en ecrivant : 

<xsl :element name=" {$el ementName} "> 

au lieu de : 

<xsl :element name="$elementNaine"> 

on a la solution. 

Rappelons que I'on veutobtenirquelque chose qui commence ainsi : 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 

<ACC0RD> 
<DEDEC> 

<field>beginning_date</field> 

<type>BusinessDate</type> 
</DEDEC> 
<CCETF> 

<field>state</field> 
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<type>String</type> 
</CCETF> 
<N0ACA> 

<field>company_id</field> 

<type>Stri ng</type> 
</N0ACA> 

Un element comme <dedec> sera genere en allant chercher le texte situe juste avant le 
<tab/> courantdans lefichier tables. xmi (voir Premiere <?tape, page 279), en recuperant 
ce texte dans une variable eiementName, et en utilisant cette variable comme montre ci- 
dessus, dans une i nstruction xsi : ei ement. 

Un element comme <fieid>beginnir,g_date</fieid> sera genere en allant chercher la 
traduction du texte contenu dans $eiementName, obtenue par un dictionnaire (le fichier 
fields. xmi vu ci-dessus). Nous emploierons la meme technique que celle vue a la sec- 
tion Exemple, page 223, avec le dictionnaire lu en tant que source externe par la fonction 

documentC ). 

Enfin, un element comme <type>string</type> sera genere en allant chercher le texte 
situe juste apres I 'element <tab/> courant, et en testant s'il contient la chalne char ou 

VARCHAR. 

On aboutit done au canevas suivant : 

<xsl :for-each select="tab"> 

<!-- ici : eiementName = le texte situe juste avant le <tab> courant --> 

<xsl :element name="{$elementName}"> 

<field> 
<!-- 

ici placer la traduction de SelementName, 
obtenue par un dictionnaire 

--> 
</field> 

<type> 

<!-- ici: typeSQL = le texte situe juste apres le <tab> courant --> 

<xsl : choose> 

<xsl :when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl :when test="contains( StypeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 
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<xsl:when test="contains( StypeSQL, ' NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 

</type> 

</xsl :element> 

</xsl :for-each> 

Le programme de fusion-synthese des documents tables. xmi et fieids.xmi est done 
celui-ci : 

mapping. xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl :param name="dicoFileRef">fields.xml</xsl :param> 

<xsl :variable name="Dictionnaire" select="document($dicoFileRef )/fields"/> 

<xsl :template match="/"> 
<mapping> 

<xsl :apply-templates/> 
</mapping> 
</xsl :template> 



<xsl :template name="traduction"> 
<xsl:param name="motId"/> 

<xsl ivariable 

name="saTraduction" 

select="$Dictionnaire/field[@id=$motId]" /> 

<xsl :val ue-of select="normalize-space($saTraduction)" /> 
</xsl :template> 

<xsl : tempi ate match="tabl e"> 
<table> 

<xsl :value-of sel ect="@name"/> 
</table> 

<xsl:element name="{@name}"> 
<xsl :for-each select="tab"> 
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<xsl :vari abl e name="el ementName" 

select=" normal ize- space ( 

preceding- sibl ing: : text( ) [1] 
)"/> 

<xsl :element name="{$elementName}"> 
<field> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" sel ect="$el ementName" /> 

</xsl :call-template> 
</field> 
<type> 

<xsl :variable name="typeSQL" select="normalize-space( 

fol 1 owing- sibl ing: : text( ) [1] 
)"/> 

<xsl :choose> 

<xsl:when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, ' NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :element> 

</xsl :for-each> 
</xsl :element> 

</xsl :templ ate> 



<xsl :templ ate match="text( )"/> 
</xsl :stylesheet> 

On obtientcommeresultatlefichier mapping. xmi montreau debut de la section Exemple 
plus e'volue, page 275. 

Variante syntaxique namespace="..." 

Onpeutsi I 'on veut aj outer un attri but namespace, commececi : 

xsl : element 

I <xsl : element name="..." namespace=" . . . "> 
<!-- modele de transformation --> 
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<!-- fin du modele de transformation --> 
</xsl :element> 

L'attri but namespace (une chaine de caracteres) permet d'affecter un domaine nominal a 
I 'element qui va etrecree. Un descripteur de valeur differee d'attri but estaccepte ici. La 
chaine de caracteres qui constitue le domaine nominal n'est pas analysee par le proces- 
ses XSLT, done aucun control ede validite de cette chaine n'est effectue. 

Notons d'emblee que la maniere la plus simple d'affecter un domaine nominal aux ele- 
ments XM L crees par un programme XSLT n'est pas d'uti I iser I 'instruction xsi : element 

avec l'attri but namespace , 

Exemple sans namespace-'..." 

N ous reprenons ici I 'exemple vu a la section Suite de I 'exemple, page 270, et nous suppo- 
sons que le domaine nominal des elements a generer doit etre "http://concerts.ana- 
creon.org/vioie-de-gambe", et que ce domaine nominal est un domaine par defaut. 
Dans ce cas, il n'a y presque rien a faire, si ce n'est de declarer le domaine nominal en 
question dans la racinedu programme : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns=" http://concerts.anac reon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1' /> 
<xsl:param name="declamationFileRef" select=" 'deel amationTail 1 e.xml ' " /> 
<xsl :variable name="declaination" 

sel ect="document( $declamationFileRef )/texte" /> 

<xsl :template match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :templ ate> 

<xsl :template match="prol ogue"> 
<prol ogue> 

<xsl :value-of select="$declamation/titre"/> 
</prologue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No=" { . }"> 

<xsl :val ue-of sel ect="$decl amati on/pa roles/p[positi on ( )=$i]"/> 
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</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
Oecitant xmlns=" http: //concerts .anacreon.fr/viol e-de-gambe"> 
<prol ogue> 

Le Tableau de l'Operation de la Taille 

</prologue> 

<mesure No="l">L' aspect de 1 'apareil .</mesure> 
<mesure No="8">Fremissement en le voyant.</mesure> 
<mesure No="ll">Resolution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27">Icy se fait 1 'incision. </mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici l'on tire la piere.</mesure> 
<mesure No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50">Icy l'on oste les soyes. </mesure> 
<mesure No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

L'element<recitant> a ete equipe d'un attri but xmi ns qui donne ledomaine nominal par 
defaut, et toute la descendance (enfants, petits-enfants, etc.) herite de ce domaine nomi- 
nal par defaut. Les elements <proiogue> et <mesure> sont done eux aussi dans le 

domaine nominal http: //concerts . anacreon . f r/viol e-de-gambe, 

Autre exemple sans namespace-'..." 

Une autre possibility est de declarer un domaine nominal explicite pour chaque element 
cree. Cela se fait tres simplementen donnantexplicitement leprefixe (ou abreviation) du 
domaine nominal a utiliser, a condition que ce domaine ait ete declare et soit visible a 
I'endroit ou I 'abreviation est utilisee : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http: //www. w3.org/1999/XSL/Transform" 

xmlns:vdg=" http: //concerts. anacreon.fr/viol e-de-gambe" 

version="1.0"> 

<xsl:output method^'xml' indent="yes" encoding='IS0-8859-l' /> 
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<xsl:param name="declamationFileRef" sel ect=" 'decl amationTail 1 e.xml ' " /> 
<xsl :variable name="declaination" 

sel ect="document( SdeclamationFileRef )/texte" /> 

<xsl : tempi ate match="/"> 
<vdg:recitant> 

<xsl :apply-templates/> 
</vdg:recitant> 
</xsl :templ ate> 

<xsl :template match="prol ogue"> 
<vdg:prologue> 

<xsl :value-of sel ect="$decl amation/titre"/> 
</vdg:prologue> 
</xsl :templ ate> 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<vdg:mesure No="{ . }"> 

<xsl : val ue-of sel ect="$decl amati on/pa rol es/p[position( )=$i ]"/> 
</vdg:mesure> 
</xsl : for-each> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

R esultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<vdg:recitant xmlns:vdg=" http://concerts.anac reon.fr/viole-de-gambe"> 
<vdg:prologue> 
Le Tableau de 1 'Operation de la Taille 
</vdg:prologue> 

<vdg:mesure No="l">L'aspect de 1 'apareil .</vdg:mesure> 
<vdg:mesure No="8">Fremi ssement en le voyant.</vdg:mesure> 
<vdg:mesure No="ll">Resol ution pour y monter.</vdg:mesure> 
<vdg:mesure No="15">Parvenu jusqu'au hault;</vdg:mesure> 
<vdg:mesure No="20">descente dudit apareil .</vdg:mesure> 
<vdg:mesure No="22">Reflexions serieuses.</vdg:mesure> 
<vdg:mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</vdg:mesure> 
<vdg:mesure No="27">Icy se fait 1' incision. </vdg:mesure> 
<vdg:mesure No="31">Introduction de la tenette.</vdg:mesure> 
<vdg:mesure No="39">Ici l'on tire la piere.</vdg:mesure> 
<vdg:mesure No="44">Icy l'on perd quasi la voix.</vdg:mesure> 
<vdg:mesure No="48">Ecoul ement du sang.</vdg:mesure> 
<vdg:mesure No="50">Icy l'on oste les soyes. </vdg:mesure> 
<vdg:mesure No="53">Icy l'on vous transporte dans le lit.</vdg:mesure> 
</vdg:recitant> 
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Exempleavec namespace="..." 

Enfin, nous en arrivons a une solution ou on utiliseeffectivement I'attribut namespace de 

^instruction xsl :element : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding='IS0-8859-l' /> 
<xsl:param name="declamationFileRef" select=" 'decl amationTai 1 1 e.xml ' " /> 
<xsl :variable name="declamation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl :template match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :templ ate> 

<xsl : tempi ate match="prologue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl :templ ate> 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl ivariable name="i" select="position( )" /> 
<xsl:element name="mesure" 

names pace=" http: //concerts .anacreon .f r/viol e-de-gambe"> 
<xsl :attribute name="No"Xxsl :val ue-of select="."/> 
</xsl :attribute> 

<xsl rvalue -of select="$declamation/paroles/p[position( )=$i]"/> 
</xsl :element> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prologue> 

<mesure xml ns=" http: //concerts. anacreon .f r/viol e-de-gambe" No="l"> 
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L'aspect de 1 'apareil .</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="8"> 

Fremissement en le voyant.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="ll"> 

Resolution pour y monter.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="15"> 

Parvenu jusqu'au hault;</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="20"> 

descente dudit apareil .</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="22"> 

Reflexions serieuses.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="23"> 

Entrel assement des soyes 
Entre les bras et les jambes.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="27"> 

Icy se fait 1 'incision. </mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="31"> 

Introduction de la tenette.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="39"> 

Ici l'on tire la piere.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="44"> 

Icy l'on perd quasi la voix.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="48"> 

Ecoulement du sang.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="50"> 

Icy l'on oste les soyes. </mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="53"> 

Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

Ici, il n'y a pas grand interet a proceder de la sorte, puisque I 'element <mesure> n'a pas 
d'element fils. Le domaine nominal par defaut est inutilement repete pour chaque 
<mesure>, alors qu'il aurait ete plus simple, comme on I 'a vu plus haut, de declarer ce 
domaine nominal par defaut directement sur I 'element racine <recitant>. 



Variante syntaxique use-attribute-sets="..." 

Cet attri but va de pair avec instruction xsi : attribute-set, qui sera etudiee plus loin 
(voir Instruction xsl: attribute- set, page 304). 



Instruction xshattribute 

Bande-annonce 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 
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<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 
<Compositeur>M 
<Compositeur>D 
<Compositeur>F 
</Compositeurs> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xml ' encodings' ISO-8859-1' indent='yes' /> 

<xsl : tempi ate match="/"> 

<Interpretes> 

<xsl : apply-templ ates/> 

</Interpretes> 
</xsl :templ ate> 

<xsl :template match="Interprete"> 
<Interprete> 

<xsl :attribute name="Nom"> 

<xsl :value-of select="./Nom"/> 



. Marais</Compositeur> 
. Castello</Compositeur> 
. Rognoni</Compositeur> 
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</xsl :attribute> 

<xsl :attribute name="Instrument"> 

<xsl :value-of select=" . /Instrument"/> 
</xsl :attribute> 
</Interprete> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Interpretes> 

<Interprete Nom=" Jonathan Dunford " Instrument="Basse de viole"/> 
<Interprete Nom=" Sylvia Abramowicz " Instrument="Basse de viole"/> 
<Interprete Nom=" Benjamin Perrot " Instrument="Theorbe et Guitare baroque"/> 
</Interpretes> 

Syntaxe 

L'instruction <xsi :attribute> permet de creer un nouvel attri but, dont le nom estfourni 
par I'attribut name, et la valeur par le modele de transformation associe. Elle prend la 
forme suivante : 

xsl : attribute 

<xsl : attribute name=" . . . "> 

<!-- modele de transformation propre a xsl attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 

L'instruction xsi :attribute ne doit pas apparaltre en tant qu'instruction de premier 
niveau. 

Regie XSLT typique 

Comme un attri but ne peut pas apparaitre isolement dans un document XM L, l'instruc- 
tion <xsi :attribute> esttoujoursassocieed'unemaniereou d' une autre a une instruction 
de creation d'element. Les deux formes syntaxiques qui suivent sont couramment 
employees pour real iser cette association. 

L'instruction <xsi :attribute> peut s'utiliser en tant que complement pour l'instruction 
<xsi :eiement>, qui prend alors la forme suivante : 

xsl attribute 



<xsl:element name="..."> 

<xsl attribute name="..."> 
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<!-- modele de transformation propre a xsl rattribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl :attribute> 
<xsl rattribute name="..."> 

<!-- modele de transformation propre a xsl rattribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl :attribute> 

... autres instructions <xsl :attribute> ... 

<!-- modele de transformation propre a xsl:element --> 

<!-- fin du modele de transformation propre a xsl:element --> 
</xsl :el ement> 

Les instructions <xsi :attribute> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de I'instruction <xsi :eiement> ; il est interdit de les diluer 
parmi I'ensembledes enfants existants. 

L'instruction <xsi :attribute> peut aussi etre utilisee pour fournir un attri but a un ele- 
mentXML faisant parti ed'un element source I itteral : 

xsl : attribute 

<xxx> 

<xsl rattribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl rattribute name="..."> 

<!-- modele de transformation propre a xsl rattribute --> 

<!-- fin du modele de transformation propre a xsl rattribute --> 
</xsl :attribute> 

... autres instructions <xsl rattribute) ... 

<!-- modele de transformation propre a 1 'element xxx --> 

<!-- fin du modele de transformation propre a 1 'element xxx --> 

<xxx> 

Les instructions <xsi :attribute> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de I'element <xxx> ; il est interdit de les diluer parmi 
I'ensemble des enfants existants. 

Emploi moins typique 

Les deux formes syntaxiques que nous venons de voir pour real i ser I'association entre 
attri but et element ne sont pas les deux seules possibles, ce sont seulement les plus cou- 
rantes. 
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En fait, ce qui compte, dans la realisation de cette association, ce n'est pas la proximite 
topologique et statique de deux instructions placees en regard I'une de I'autre dans le 
fichier sourceXSLT, maisla proximite temporel I eetdynami que : il faut que I 'instruction 
<xsi :attribute> soit instanciee juste apres une instruction <xsi :eiement> ou une autre 

instruction <xsl : attri bute>. 

Les deux formes syntaxiques vues ci-dessus permettent de facon evidente d'obtenir ce 
resultat, maisil y en au moins une autre, consistant a instancier I'instruction <xsi:eie- 
ment> dans un modele nomme, et I'instruction <xsi :attn'bute> dans un autre modele 
nomme. Dans ce cas de figure, les deux instructions <xsi :attn'bute> et <xsi :eiement> 
peuvent etre tres el oignees I'une de I'autre tout en etant dynamiquement associees. 

Et finalement, il en reste encore une derniere : celle consistant a prendre I'une des deux 
formes typiques (voir Regie XSLT typique, page 291), et a intercaler des instructions 
quelconques entrela premiere instruction xsi attribute et I 'element dont ell e depend, a 
condition que ces instructions ne creent rien dans le document resultat. N ous verrons cela 
dansun prochain exemple (voir Exemple pluse'volue, page 295). 

Semantique 

U n nouvel attri but est cree, et attache a son element parent ; le nom de cet attri but est 
fourni par la valeur de I 'attri but name, valeur qui peut, si I'on veut, etre fournie sous 
forme d'un descripteur de valeur differee d'attri but (AVT) : le nom de I 'attri but n'est 
done pasforcement unechalne« en dur » dans le programme XSLT (e'est I'un des rares 
endroits, en XSLT, ou un descripteur de valeur differee d'attri but est autorise). Quant a sa 
valeur, e'est le fragment de document resultat de I'instanciation du modele de transfor- 
mation propre a I'instruction xsi :attribute en cours. Ce fragment de document resultat 
doit etre un texte ordinaire, sans aucun element XM L (pas de baliseXM L). 

Dans ce processus de creation et d'attachement d'un attri but a son element parent, ce 
n'est pas une erreur si I 'element parent possede deja un attri but de meme nom. Le dernier 
ajoute I'emporte. Nous reverrons cela un peu plus loin (voir Complements, page 319). 

Regie du pape 

Premier ajoute, premier ecrase : e'est cela la regie du pape. Autrementdit, le dernier ajoute I'emporte, comme 
on vient de le voir. Cette regie sert a plusieurs reprises dans la suite. 

Exemple trivial 

Le premier exemple reprend la feuille de style qui nous avions vu a la section Suite de 
I 'exemple, page 270, avec laquelle il fallait obtenir I e resultat suivant : 

interventionRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
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Le Tableau de l'Operation de la Taille 
</prologue> 

<mesure No="l">L' aspect de l'apareil .</mesure> 
<mesure No="8">Fremissement en le voyant.</mesure> 
<mesure No="ll">Resolution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes .</mesure> 
<mesure No="27">Icy se fait 1 'incision. </mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici l'on tire la piere.</mesure> 
<mesure No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50">Icy l'on oste les soyes. </mesure> 
<mesure No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

II est immediat de transformer la feuille de style fusion. xsi pour utiliser I'instruction 

xsl : attri bute '. 



fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 



<xsl:output method^'xml' indent="yes" encodings' ISO-8859-1' /> 
<xsl:param name="decl amationFi 1 eRef " select^" 'declatnationTaille.xml ' " /> 
<xsl : variable name="declamation" 

sel ect="document( $declamationFileRef )/texte" /> 



<xsl : tempi ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :templ ate> 



<xsl :template match="prol ogue"> 
<prol ogue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position()" /> 
<!-- c'est ici que cela change --> 
<mesure> 
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<xsl :attribute name="No"> 

<xsl :val ue-of select="."/> 
<xsl :attribute/> 

<xsl :val ue-of select="$declamation/paroles/p[position() = $i]"/> 
</mesure> 
<!-- --> 
</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Cette version n'apporte rien de mieux a eel le que nous avions deja vue ; el I e meme un 
peu moins claire a la lecture. Comme nous I'avions deja dit a propos de I'instruction 
xsi :eiement, I'instruction xsi : attri buten'est vraiment interessante que si le nom de 
I 'attri but est calcule par le programme. Sinon, si e'est uniquement la valeur qui est calcu- 
lee par le programme, autant mettre le resultat du calcul dans une variable et utiliser un 
descripteur de valeur differee d'attribut, comme nous I'avions fait dans la version prece- 
dente du programme ci-dessus (voir section Suite de I 'exemple, page 270). 



Exemple plus evolue 

Nous allons maintenant ameliorer le programme vu a la section Exemple plus evolue, 
page 275, e'est-a-dire le rendre plus conforme aux vraies attentes, qui sont en fait d'obte- 
nir un resultat tel quecelui-ci : 

mapping.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 

<ACC0RD> 
<DEDEC> 

<f i el d>begi nni ng_date</f i el d> 
<type>BusinessDate</type> 
</DEDEC> 

<CCETF CHAR="1"> 

<field>state</field> 

<type>String</type> 
</CCETF> 

<N0ACA CHAR="6"> 

<f i el d>company_i d</f i el d> 

<type>String</type> 
</N0ACA> 

<N0P0A VARCHAR2="35"> 

<f ield>contract_nbr</f ield> 

<type>String</type> 
</N0P0A> 

<CCPAA1 NUMBER="4"> 

<f 1 el d>country_code</f i el d> 
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<type>Integer</type> 
</CCPAAl> 
</ACC0RD> 

<table>COMPANY</table> 
<C0MPANY> 

<N0ACA CHAR="6"> 

<f i el d>company_i d</f i el d> 
<type>Stri ng</type> 
</N0ACA> 

<LSACA1 VARCHAR2="35"> 

<f iel d>company_name</f ield> 

<type>Stri ng</type> 
</LSACAl> 

<CCPAA1 NUMBER="4"> 

<f i el d>country_code</f iel d> 

<type>Integer</type> 
</CCPAAl> 

<LAACA1 VARCHAR2="35"> 

<field>address</field> 

<type>Stri ng</type> 
</LAACAl> 

<URL VARCHAR2="40"> 

<field>URL</field> 

<type>Stri ng</type> 
</URL> 

< STAT RAT VARCHAR2="1"> 

<f iel d>qual i ty_code</f iel d> 
<type>Stri ng</type> 
</STATRAT> 
</C0MPANY> 
</mapping> 

II s'agit done d'ajouter a chaque element un attri but donnant son type SQL ainsi que sa 
longueur, sauf si la longueur n'est pas une information pertinente (cela ne concerne que 
les dates, dans notreexemple : I 'element <dedec>). 

Le changement est tres simple a effectuer, car la structure du programme XSLT ne 
change pas. Par commodite, nous al Ions toutefois declarer des variables qui contiendront 
le nom et la valeur de ces nouveaux attri buts a emettre dans le document resultat. 

La regie princi pale du programmeXSLT que nous avions mis au point etait eel le-ci : 

<xsl : tempi ate match="tabl e"> 
<table> 

<xsl :val ue-of sel ect="@name"/> 
</table> 

<xsl:element name=" (@name} "> 
<xsl :for-each select="tab"> 

<xsl :variable name="el ementName" 
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sel ect= "normal ize-space( 

preceding-si bl ing: :text( )[1] 
)"/> 

<xsl :element name=" ($el ementName) "> 



<field> 

<xsl : call -tempi ate name="traduction"> 

<xsl :with-param name="motId" select="$elementName" /> 

</xsl : call -tempi ate> 
</field> 
<type> 

<xsl :variable name="typeSQL" select="normalize-space( 

fol 1 owing-si bl ing: :text( ) [1] 
)"/> 

<xsl :choose> 

<xsl:when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 



<xsl :when test="contains( $typeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 



<xsl:when test="contains( $typeSQL, ' NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :el ement> 



</xsl :for-each> 
</xsl :element> 



</xsl :templ ate> 

Etant donne la chalne de caracteres -number^)" par exemple, valeur de la variable 
typeSQL, le nom du type proprement dit est donne par I'expression substring-beforec 
$typeSQL, 'c ), c'est-a-dire la sous-chaine qui s'arrste juste avant la 'C. 

La fonction substring-beforeo est une fonction standard XSLT, I'une des rares qui 
permettededecortiquer uneString. Ellea son symetrique, substring-after( ), qui va lui 
aussi nous servir : 

<xsl :variable name="typeSQL" select="normalize-space( 

following-sibling: :text()[l] 
)"/> 



<!-- ici, typeSQL vaut par exemple "NUMBER(4)" --> 

<xsl :variable name="attributeName" 

select="substring-before( $typeSQL, '(' )"/> 
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<!-- dans ce cas, attributeName vaut "NUMBER" --> 

<xsl :variable name="typeSQL-after" 

select="substring-after( $typeSQL, '(' )"/> 

<!-- et typeSQL-after vaut "4)" --> 

<xsl :variable name="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

<!-- et final ement attributeValue vaut "4" --> 

A I'issuede ces instanciations de variables, on tient le nom et la valeur de I 'attri but cou- 
rant. M ais il faut verifier que ce nom n'est pas une chaine vide, car I'instanciation d'un 
attri but dont le nom est vide n'a clairement aucun sens, et provoque uneerreur. 

Or, il peut arriver que le nom soit vide, parce que la fonction substring-beforec ) ren- 
voie une chaine vide si le marqueur recherche, une "(" dans notre exemple, n'existe pas 
dans la chaine examinee. Et de fait, cela se produira pour le type date, qui ne mentionne 
pas de longueur. 

<xsl :variable name="typeSQL" select="noririalize-space( 

following-sibling: :text()[l] 
)"/> 

<xsl :variable name="attributeName" 

select="substring-before( StypeSQL, '(' )"/> 

<xsl :variable name="typeSQL-after" 

select="substring-after( $typeSQL, '(' )"/> 

<xsl :variable name="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

<xsl:if test="$attributeName"> 

<xsl :attribute name="{$attributeName}" > 
<xsl :value-of select="$attributeValue"/> 

</xsl :attribute> 
</xsl :if> 

La valeur de I 'attri but test est convertie en booleen ; on rappelle (voir Fonctions Boo- 
le'ennes, page 636) que la conversion d'une String en booleen donne true si et seulement 
si la String n'est pas de longueur nulle, d'ou le test ci-dessus. 

Le programme XSLT se deduit de toutes ces remarques, et donne bien le resultat montre 
au debut decette section. 

mapping.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 
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xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='xinl ' indent="yes" encoding=' ISO-8859-1 ' /> 
<xsl :param name="dicoFileRef">fields.xml</xsl :param> 

<xsl :variable name="Dictionnaire" select="document($dicoFileRef )/fields"/> 

<xsl : tempi ate match="/"> 
<mapping> 

<xsl :apply-templates/> 
</mapping> 
</xsl :template> 



<xsl :template name="traduction"> 
<xsl:param name="motId"/> 



<xsl :variable 

name="saTraduction" 

select="$Dictionnaire/field[@id=$motId]" /> 



<xsl :value-of select="normalize-space($saTraduction)" /> 
</xsl :template> 



<xsl :template match="tabl e"> 
<table> 

<xsl :value-of sel ect="@name"/> 
</table> 



<xsl:element name="{@name}"> 



<xsl : for-each select="tab"> 



<xsl :variable name="elementName" 

sel ect= "normal ize-space( 

preceding-si bl ing: :text( )[1] 
)"/> 

<xsl :element name=" {$el ementName} "> 

<xsl :variable name="typeSQL" select="normalize-space( 

fol 1 owing- si bl ing: : text( ) [1] 
)"/> 



<xsl :variable name="attributeName" 

select="substring-before( StypeSQL, '(' )"/> 

<xsl :variable name="typeSQL-after" 

select="substring-after( StypeSQL, '(' )"/> 

<xsl :variable name="attributeVal ue" 

select="substring-before( StypeSQL-after, ')' )"/> 
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<xsl :if test="$attributeName"> 

<xsl :attribute name="{$attributeName}" > 

<xsl :value-of select="$attributeValue"/> 
</xsl :attribute> 

</xsl :1f> 

<field> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" sel ect="$el ementName" /> 
</xsl :cal 1 -tempi ate> 
</field> 

<type> 

<xsl :choose> 

<xsl :when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, ' NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :element> 

</xsl :for-each> 
</xsl :element> 

</xsl :templ ate> 



<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Variante syntaxique namespace="..." 

Onpeutsi I 'on veutaj outer un attri but namespace, comme ceci : 

xsl : attribute 

<xsl :attribute name="..." namespace=" . . . "> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :el ement> 
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L'attribut namespace (une chaine de caracteres) permet d'affecter un domaine nominal 
a l'attribut qui va etre cree. Un descripteur de valeur differee d'attri but est accepte ici. 
La chaine de caracteres qui constitue le domaine nominale n'est pas analysee par le pro- 
cesseur XSLT, done aucun controle de validite de cette chaine n'est effectue. 



Exemple avec namespace="..." 

Nous reprenons I 'exemple vu a la section Exemple avec namespace="...", page 288, dans 
lequel nous dedarons un domaine nominal uniquement pour l'attribut : 

mapping.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xinl ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declainationFileRef" sel ect=" 'deel amationTai 1 le.xml' " /> 
<xsl :variable name="declamation" 

sel ect="document( SdeclamationFileRef )/texte" /> 

<xsl :template match="/"> 
<recitant> 

<xsl : apply-templ ates/> 
</recitant> 
</xsl :templ ate> 

<xsl :template match="prol ogue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl :templ ate> 

<xsl : tempi ate match="Numeros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl : vari abl e name="i" select="position( )" /> 
<xsl:element name="mesure" > 
<xsl :attribute name="No" 

namespace^" http://concerts.anac reon.fr/viole-de-gambe"> 
<xsl :val ue-of select="."/> 
</xsl :attribute> 

<xsl :value-of select="$declamation/paroles/p[position() = $i]"/> 
</xsl :element> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 

Le Tableau de l'Operation de la Taille 

</prologue> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="l"> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="8"> 

Fremissement en le voyant.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="ll"> 

Resolution pour y monter.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="15"> 

Parvenu jusqu'au hault;</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="20"> 

descente dudit apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="22"> 

Reflexions serieuses.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="23"> 

Entrel assement des soyes 
Entre les bras et les jambes.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="27"> 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="31"> 

Introduction de la tenette.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="39"> 

Ici l'on tire la piere.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="44"> 

Icy l'on perd quasi la voix.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="48"> 

Ecoulement du sang.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="50"> 

Icy l'on oste les soyes. </mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="53"> 

Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

On voit qu'ici, le processeur XSLT a ete oblige d'inventer une abreviation pour le 
domaine nominal choisi, car la declaration xmins="..." prend place dans I 'element 
<mesure>, mais ne doit pas pour autant s'appliquer a cet element. Si le domaine nominal 
avait ete declare sans abreviation, cela aurait ete un domaine nominal par defaut, qui se 
serait done applique a I'element <mesure> lui-meme, chose que l'on veut precisement 
eviter. 

M ais la encore, il reste plus simple de declarer le domaine nominal souhaite (avec son 
abreviation) dans la racinedu programme XSLT, et d'uti I iser explicitementcette abrevia- 
tion partout oil e'est necessaire, commedans I'exemplede la section Autre exemple sans 
namespace="...", page 286. 
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mapping.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
xmlns:vdg=" http://concerts.anacreon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method='xinl ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " sel ect=" 'decl amationTai 1 le.xml ' " /> 
<xsl :variable name="declamation" 

sel ect="docuinent( SdeclamationFileRef )/texte" /> 

<xsl :template match="/"> 
<recitant> 

<xsl : apply-templ ates/> 
</recitant> 
</xsl :templ ate> 

<xsl :template match 
<prologue> 

<xsl : val ue-of 
</prol ogue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl ivariable name="i" select="position( )" /> 
<xsl:element name="mesure" > 
<xsl :attribute name="vdg:No"> 
<xsl :val ue-of select="."/> 
</xsl :attribute> 

<xsl :value-of select="$declamation/paroles/p[position() = $i]"/> 
</xsl :element> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<recitant xml ns:vdg="http: //concerts. anacreon.fr/viole-de-gambe"> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure vdg:No="l">L'aspect de 1 'apareil .</mesure> 
<mesure vdg:No="8">Fremissement en le voyant.</mesure> 
<mesure vdg:No="ll">Resol uti'on pour y monter.</mesure> 
<mesure vdg:No="15">Parvenu jusqu'au hault;</mesure> 
<mesure vdg:No="20">descente dudit apareil .</mesure> 



="prol ogue"> 
select="$decl amation/ti tre"/> 
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<mesure vdg:No="22">Reflexions serieuses.</mesure> 
<mesure vdg:No="23">Entrelassement des soyes 
Entre les bras et les jambes .</mesure> 
<mesure vdg:No="27">Icy se fait 1 'incision. </mesure> 
<mesure vdg:No="31">Introduction de la tenette.</mesure> 
<mesure vdg:No="39">Ici l'on tire la piere.</mesure> 
<mesure vdg:No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure vdg:No="48">Ecoulement du sang.</mesure> 
<mesure vdg:No="50">Icy l'on oste les soyes. </mesure> 
<mesure vdg:No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 
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Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

</Concert> 

L'instruction <xsi : attribute-set name="..."> est utilisee pour definir des groupe- 
ments d'attri buts qui reviennent en plusieurs endroits d'un programme, lors de I'instan- 
ciation d'elements (par ^instruction <xsi :eiement> ) dans le document resultat. Le 
regroupement de la definition deces attri buts faci lite la maintenance ou les evolutions du 
programme. 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'html ' encodings IS0-8859-1' /> 



<xsl :attribute-set name="body-attributes"> 

<xsl :attribute name="leftmargin">150</xsl :attribute> 
<xsl :attribute name="bgcol or">#ddeef f</xsl :attribute> 
<xsl :attribute name="text">bl ack</xsl :attribute> 

</xsl :attribute-set> 
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<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl :value-of select="/Concert/Entete"/X/title> 
</head> 

<xsl :element name="body" use-attribute-sets="body-attributes"> 

<xsl :apply-templates/> 
</xsl :el ement> 
</html> 
</xsl :templ ate> 

<xsl :template match="Enseinbl e"> 

<H2 align="center"> Ensemble <xsl :value-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 

Resultat 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> «Les Concerts d'Anacréon» </title> 
</head> 

<body leftmargin="150" bgcol or="#ddeeff " text="bl ack"> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
</body> 
</html> 

Syntaxe 

L'instruction <xsi :attribute-set> permet de definir un ensemble d'attributs qui pour- 
ront etre attaches en une seule fois a un element en utilisant l'instruction <xs:eiement 
name=" ..." use-attri bute-sets=" . . . ">, ou bien en utilisant un element source litteral 
avec un attri but xsi : use-attri bute-sets=" ..." (voi r Variante de I 'exemple, page 312). 

Note 

II y a aussi une autre instruction qui peutuuiiserl'attribut use-attribute-sets dans le meme but, c'est l'instruc- 
tion <xsi :copy>, que nous verrons plus loin (voir Instruction xshcopy, page 321). Attention a ne pas confondre 
<xsi :copy> et<xsi :copy-of>, dejavue (voir Instruction xsl:copy-of, page 156). 

xsi :attribute-set 

<xsl :attribute-set name=" . . . "> 

<!-- modele de transformation propre a xsi :attribute-set --> 
<xsl :attribute name="..."> 
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<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl :attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 

<!-- etc. autant d'attributs que 1'on veut, mais rien que des attributs --> 
<!-- fin du modele de transformation propre a xsl :attribute-set --> 
</xsl :attribute-set> 

L'instruction xsi :attribute-set doit apparaitre en tantqu' instruction de premier niveau. 



Semantique 

L'instanciation d'une instruction xsi :attribute-set consiste a instancier toutes les ins- 
tructions xsi : attribute qu'el le contient. 

Bien que I'element xsi :attribute-set soit une instruction de premier niveau, comme 
I'est la definition d'une variable ou d'un parametre global, el I e n'est pas instanciee en 
meme temps que les variables ou parametres globaux. 

Pour une variable global e, l'instanciation n'a lieu qu'une seulefois, avant que le moteur 
de transformation ne commence a traiter la racine du document ; le nceud contexte pour 
devaluation decette variable global e est le noeud racine de I'arbreX M L du document. 

Pour instruction xsi :attribute-set, l'instanciation est differee jusqu'au moment ou 
el I e est effectivement necessaire a l'instanciation d'une instruction xsi :eiement 
redamant cet attribute-set. Bien plus, l'instanciation du modele de transformation 
d'une instruction xsi :attribute-set est relancee a chaque fois qu'une instruction de 
xsi :eiement referencant cet attribute-set est instanciee. 

Le noeud contexte utilise pour l'instanciation d'une instruction xsi : attribute-set est le 
meme que celui qui est actif lors de l'instanciation de instruction xsi :eiement qui fait 

appel a Cet attribute-set. 

Par exemple, instruction : 

<xsl :attribute-set name="truc"> 
<xsl :attribute name="machin"> 
<xsl :value-of select="."/> 
</xsl :attribute> 
<xsl :attribute name="bidul e"> 

<xsl :val ue-of select=" . . "/> 
</xsl :attribute> 
</xsl :attribute-set> 

peutetre reinstancieede nombreuses fois, avec a chaque fois un noeud contexte different 
(done des valeurs differentes pour les expressions evaluees par I e select des xsi :vai ue- 
of). 
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De ce point de vue (invariance du nceud contexte entre I'appel et I'instanciation), ['ins- 
truction xsl : attribute-set Se COmporte COITIITie instruction xsl : tempi ate name= 

". . .", mais avec la grande difference qu'il n'existe aucun moyen pour transmettre un 
argument ou parametre a une instruction xsi :attribute-set (la seule chose effective- 
menttransmise est done lenoeud contexte). 

Rien n'empeche pourtant une instruction xsi :attribute-set de faire reference a des 
variables ou parametres, mais etant donne les regies de visibility (voir Regies de visibi- 
lity page 212), ce ne peut etre que des variables ou parametres globaux, qui ont une 
valeur fixee une fois pour toutes. 

Variante syntaxique use-attribute-sets="..." 

On peut si I'on veutajouter un attri but use-attribute-sets, commececi : 

xsl :attribute-set 

<xsl :attribute-set name="..." use-attribute-sets=" . . . "> 

<!-- modele de transformation propre a xsl :attribute-set --> 
<xsl attribute name=" . . . "> 

<!-- modele de transformation propre a xsl attribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl :attribute> 
<xsl attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xs1 : attribute --> 
</xsl :attribute> 

<!-- etc. autant d'attributs que l'on veut, mais rien que des attributs --> 
<!-- fin du modele de transformation propre a xsl :attribute-set --> 
</xsl :attribute-set> 

L'attri but use-attribute-sets=" ..." (une liste de noms d'attribute-set separes par 
des espaces blancs) permetde placer dans I'attribute-set en cours de construction des 
attributs provenant d'autres attribute-set. Bien sur, et comme toujours dans ce genre 
de situation, les references circulaires sont interdites, car el les sont impossibles a traiter 
et denuees de sens. 

Exemple 

Remarque 

Cet exemple Utilise Instruction <xsl : element name=" ..." use-attribute-sets=". . . ">. 

On voit souvent la notion d'attibute-set i 1 1 ustree par des exemples dans ledomainede 
I'enrichissementtypographiqueen HTM L de textes a visual iser surun navigateur.Jen'ai 
jamais trouve ce genre d'exemple tres bien choisi, car CSS est justement fait pour 9a, et 
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c'est bien plus simple qu'avec XSLT : il suffit de defini r un et un seul attri but class dans 
I'element concerne, et, dans un fichier a part, de defini r la classe CSS correspondante 
avec toutes les combinaisons d'attributs typographiques que I'on veut. Nous allons done 
nous ecarter deliberement du domaine des attri buts typographiques pour illustrer I 'utili- 
sation d'un regroupement d'attributs par attibute-set. 

Nous allons supposer ici que nous voulons creer un fichier XM L resumant les informa- 
tions de contenu des plages d'un CD, avec, pour chacune d'entre elles, les artistes qui 
interviennent, le titre de la piece jouee, et eventuellement d'autres informations encore. 
Le but est de pouvoir ensuite utiliser ce fichier comme I'une des sources d'information 
pour la realisation de la plaquette du disque, les declarations pour la perception par les 
artistes des droits sur les ventes (qui peuvent etre au prorata du mi nutage de I eur partici- 
pation), etc. 

Voici I'alluredece fichier (assez spartiate, n'etant pas destine a etre affiche) : 

plagesCD.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" org="fech"> 

Grave 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
v!2="oded" vlc="dsmp"> 
Presto / Prestissimo 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded"> 

Adagio 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
v!2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Les codes utilises sont repertories dans un autre fichier XM L, constitue a part (ce fichier 
n'intervient pas dans la transformation XSLT a realiser ; on le montre seulement pour 
fixer les idees) : 

codes PI ages .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<codes> 
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<artistes> 

<artiste id="cplu" 

<artiste id="nspt" 

<artiste id="eblq" 

<artiste id="fmrt" 

<artiste id="oded" 

<artiste id="fech" 

<artiste id="dsmp" 

</artistes> 



name="Christine Plubeau"/> 
name="Noelle Spieth"/> 
name="Eric Bellocq"/> 
name="Frederic Martin"/> 
name="0di 1 e Edouard"/> 
name="Freddy Eichelberger"/> 
name="David Simpson"/> 



<instruments> 

<instrument id="vdg" 

<instrument id= a clv" 

<instrument id="thb" 

<instrument id="vll" 

<instrument id="vl2" 

<instrument id="org" 

<instrument id="vlc" 

</instruments> 



name="Viole de gambe"/> 
name="Clavecin"/> 
name="Theorbe"/> 
name="Viol on baroque"/> 
name="Viol on baroque"/> 
name="Orgue positif"/> 
name="Violoncelle baroque"/> 



</codes> 

La transformation XSL que nous allons voir doit aboutirau fichier piagesCD.xmi en par- 
tantdu fichier sonates-jacquet-dig.xmi montre ci-dessous : 

sonates-jacquet-dlg.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<sonates> 



<compositeur> 

Elizabeth Jacquet de la Guerre 
</compositeur> 

<recueil> 

Manuscrit des sonates en duo et trio 
copiees par Sebastien de Brossard vers 1695 
</recuei 1 > 



<sonate> 
<titre> 

Suonata IV en sol mineur a 2 Violini soli 
e Violoncello obligato con organo 
</titre> 

<mouvement effecti f="bc-viol ons-orgue"> 

<titre>Grave</titre> 
</mouvement> 

<mouvement effecti f="tutti "> 

<titre>Presto / Presti ssimo</titre> 
</mouvement> 

<mouvement effecti f ="bc-vi ol ons"> 
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<titre>Adagio</titre> 
</mouvement> 

<mouvement ef fectif="tutti -orgue"> 

<titre>Presto Recit de basse</titre> 
</mouvement> 
</sonate> 

<!-- autres sonates a suivre ici --> 
</sonates> 

Dans le fichier de depart de la transformation, nous avons done des attributs representant 
I ' eff ectif par un code, I a correspondance entre I e code et ce qu' i I represente etant a etabl i r 
dans le programme XSLT, sur le principe suivant : 

• be (basse continue) = clavecin +violedegambe +theorbe 

• violons = les deux violons 

• tutti = be + violons + vi ol oncel I e 

Nous allons done definir un attibute-set pour chacune de ces combinaisons : 

<xsl :attribute-set name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 
<xsl :attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 
</xsl :attribute-set> 

<xsl : attribute-set name="vl s"> 

<xsl :attribute name="vH">fmrt</xsl :attribute> 

<xsl :attribute name="vl 2">oded</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set name="tt" use-attribute-sets="bc vls"> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :attribute-set> 

On voit ici I ' interet de I'utilisation de I ' attri but use-attribute-sets pour la definition 
d'un attribute-set : on n'a pas a repeter les declarations d'attributs faisant partie des 
groupes« be » ou « vis », cequi mai ntientunemei 1 1 eure coherence del 'ensemble en cas 
de modification de I'un deces groupes. 

Ayant ces groupements d'attributs, on peut alors traiter le fichier d'entree : 

<xsl :template match="sonate"> 

<xsl :for-each select="mouvement"> 

<xsl : choose> 

<xsl :when test="@effectif = 'bc-violons-orgue' "> 

<xsl :el ement name="plage" use-attribute-sets="bc vls"> 
<xsl rattribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
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</xsl :e1 ement> 
</xsl :when> 

Pour la combinaison « bc-violons-orgue», il suffit de prendre les groupements d'attri- 
buts « be » et « vis », et il ne manque plus que I'orgue, qu'on rajoute « a la main ». 

Le programme de transformation est done lesuivant: 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl :attribute-set name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 

<xsl :attribute name="cl v">nspt</xsl :attribute> 

<xsl :attribute name="thb">eblq</xsl :attribute> 
</xsl :attribute-set> 

<xsl : attribute-set name="vl s"> 

<xsl :attribute name="vll">fmrt</xsl :attribute> 

<xsl :attribute name="vl 2">oded</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set name="tt" use-attribute-sets="bc vls"> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :attribute-set> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl :templ ate> 

<xsl :template match="sonate"> 

<xsl :for-each sel ect="mouvement"> 

<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue'"> 

<xsl:element name="plage" use-attribute-sets="bc vls"> 
<xsl :attribute name="org">fech</xs1 :attribute> 
<xsl : val ue-of select="titre"/> 
</xsl :el ement> 
</xsl :when> 

<xsl :when test="@effectif = 'bc-violons' "> 

<xsl:element name="plage" use-attribute-sets="bc vls"> 

<xsl : val ue-of select="titre"/> 
</xsl :el ement> 
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</xsl :when> 

<xsl :when test="@effectif = 'bc-violoncel 1 e' "> 

<xsl :el ement name="plage" use-attribute-sets="bc"> 
<xsl rattribute name="vl c">dsmp</xsl :attribute> 
<xsl :value-of select="titre"/> 
</xsl :element> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti-orgue' "> 

<xsl :el ement name="plage" use-attribute-sets="tt"> 
<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</xsl :element> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti'"> 

<xsl :el ement name="plage" use-attribute-sets="tt"> 

<xsl :value-of select="titre"/> 
</xsl :element> 
</xsl :when> 
</xsl :choose> 

</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Le resultat obtenu est bien celui annonce plus haut (voir fichier piagesCD.xmi). On 
remarquera I 'inconvenient inevitable d'avoir a repeter I 'instruction <xsi :eiement> pour 
chaque<xsi :when> : la factorisation serai t possible, a condition dene pas uti I i ser I ' attri - 
but use-attribute-sets, ou alors de I'utiliser avec la meme valeur partout, ce qui est 
malheureusement contradictoire avec le but poursuivi. 



Variante de I'exemple 

Remarque 

Cet exemple utilise un element source XML litteral (hors du domaine nominal « xsl ») associe a un attribut 
xsl :use-attribute-sets=". . . " (qui lui, est dans le domaine nominal « xsl »). 

Au lieu d'utiliser ^instruction <xsi :eiement> pour appeler le ou les attribute-set uti- 
les, il est possible d'utiliser un element source litteral, etd'employer I 'attribut xsi :use- 
attri bute-sets=" . . . ", comme ceci : 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 
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<xsl:output method='xmr indent="yes" encodings' ISO-8859-1 ' /> 



<xsl :attribute-set name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 
<xsl :attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 

</xsl :attribute-set> 

<xsl :attribute-set name="vl s"> 

<xsl :attribute name="vll">fmrt</xsl :attribute> 
<xsl :attribute name="vl 2">oded</xsl :attribute> 

</xsl :attribute-set> 

<xsl :attribute-set name="tt" use-attribiite-sets="bc vls"> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :attribute-set> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl :templ ate> 

<xsl : tempi ate match="sonate"> 

<xsl :for-each sel ect="mouvement"> 

<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue'"> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :val ue-of select="titre"/> 
</pl age> 
</xsl :when> 

<xsl :when test="@effectif = 'bc-violons' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :value-of select="titre"/> 
</pl age> 

</xsl :when> 

<xsl :when test="@effectif = 'bc-violoncelle' "> 
<plage xsl :use-attribute-sets="bc"> 

<xsl :attribute name="vl c">dsmp</xsl :attribute> 
<xsl :val ue-of select="titre"/> 
</pl age> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti-orgue'"> 
<plage xsl :use-attribute-sets="tt"> 

<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</pl age> 
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</xsl :when> 

<xsl :when test="@effectif = 'tutti'"> 
<plage xsl :use-attribute-sets="tt"> 
<xsl :value-of select="titre"/> 
</pl age> 
</xsl :when> 
</xsl :choose> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="text( ) "/> 
</xsl :stylesheet> 

L'effet de cette version est exactement le meme que dans la version precedente. Comme 
dans ce programme, il n'y a a priori pas devolution envisageable qui pourrait necessiter 
derendre variable lenom del 'element <piage>, on peuta la rigueur penser que cette ver- 
sion est tres legerement meilleure, mais la difference est tout de meme assez infime. 

Commentaire de I'exemple 

Remarque 

Cetexemple utilise un attribute-set simule parun modele nomme. 



Ceci dit, comme on I'a deja remarque un peu plus haut, la notion d' attribute-set 
souffre peutetre un peu du manque de possibility de parametrage. M ais il faut bien voir 
qu'un regroupement d'attri buts n'est jamais qu'un regroupement d'attri buts, et qu'un 
regroupement d'attri buts, 5a ne doit pasetre si terrible que 5a a real iser avec les moyens 
du bord, qui sont deja assez consequents (minede rien) : 

<xsl :templ ate name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 

<xsl :attribute name="cl v">nspt</xsl :attribute> 

<xsl :attribute name="thb">eblq</xsl :attribute> 
</xsl :templ ate> 

<xsl :templ ate name="vls"> 

<xsl :attribute name="vll">fmrt</xsl :attribute> 

<xsl :attribute name="vl 2">oded</xsl :attribute> 
</xsl :templ ate> 

<xsl :templ ate name="tt"> 

<xsl :call-template name="bc"/> 

<xsl :cal 1 -tempi ate name="vl s"/> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :template> 
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On a ici des regroupements a" attribute, qui n'ont rien a envier a ceux de la section prece- 
dente, et qui en plus, ne sont pas limites en possibility de parametrage, puisque rien 
n'empecherait de transmettre a ces modeles nommes des arguments comme on peut le 
faireavec n'importequel modele nomme. 

Note 

L'interdiction de circularite, dans ce cas, semble disparaitre, puisqu'aucune interdiction de ce genre n'est asso- 
cieeaux modeles nommes, En fa it e I le ne disparaitpas vraiment: un modele nomme A peuteffectivementappe- 
lerun modele nomme B, qui en retour, peut appeler le modele A. On estalors dans un cas de recursion mutuelle, 
parfaitement autorisee. Mais evidemment, toute recursion, fut-elle croisee ou mutuelle, doit finir par s'arretersur 
une certaine condition. Sinon c'estune recursion infinle, done une erreur, qui se manifestera al'execution par la 
consommation immediate de toute la memoire disponible. 

Le plus fort, e'est que si I'on met en ceuvre une transformation avec cette facon de rea- 
liser les regroupements d 'attribute, on aboutit a une solution globalement plus simple : 
transformation plus simple et fichier d'entree plus simple. Pourquoi ? 

Parce que se serait pi us simple si I'on pouvaitaj outer des attribute-sets petit a petit, au 
fur et mesure qu'on decouvre dans la source XM L des informations qui impliquent d'en 
ajouter. M alheureusement, ce n'est pas possible. II faut donner en une seule fois la liste 
des attribute-sets a prendre encompte. On pourraiteventuellement penseraconstituer 
cette liste petit a petit, sous forme d'une chalne de caracteres qui serait ensuite fournie 
comme valeur pour I ' attri but use-attribute-sets (mais n'oublions pas qu'une variable 
n'est pas modifiable, qu'il n'y a pas d'iteration possible, et que la poursuite de cette idee 
exigerait la mise en place d'un modele nomme recursif) : 

<xsl:element name="pl age" use-attribute-sets="{$laListe}"> 

Pas de chance, I 'attri but use-attribute-sets n'est pas prevu pour accepter des descrip- 
teurs de valeurs differees d' attri but ; e'est done inutile de s'acharner a contourner cette 
difficulty e'est perdu d'avance. 

On est done oblige d'ajouter les attribute-sets en une seule fois, et e'est ce qui oblige 
le source XML a fournir toute une serie de codes qui donnent toute I 'i nformation neces- 
saire en une seule fois : 

<mouvement effecti f="bc-viol ons-orgue"> 

<titre>Grave</titre> 
</mouvement> 

et non pas : 

<mouvement> 

<titre>Grave</titre> 
<effectif> 

<basseContinue/> 
<violons/> 
<orgue/> 
</effectif> 
</mouvement> 
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Pourtant la deuxieme solution est plus i nteressante, car el I e est plus souple et plus 
simple : on ajoute ou retire ce qu'on veut, sans etre oblige d'inventer un nom de combi- 
naison pourchaquecombinaison utile. 

Mais precisement, cette deuxieme solution, plus interessante, est compatible avec une 
transformation XSLT basee sur des regroupements d'attri buts par model es nommes. 

Lefichier source XM L estmaintenantconstituecommececi : 

sonates- jacquet-dl g.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<sonates> 

<compositeur> 

Elizabeth Jacquet de la Guerre 
</compositeur> 

<recuei 1 > 

Manuscrit des sonates en duo et trio 
copiees par Sebastien de Brossard vers 1695 
</recuei 1 > 



<sonate> 
<titre> 

Suonata IV en sol mineur a 2 Violini soli 
e Violoncello obligato con organo 
</titre> 
<mouvement> 

<titre>Grave</titre> 
<effectif> 

<basseContinue/> 
<violons/> 
<orgue/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Presto / Prestissimo</titre> 
<effectif> 

<tutti/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Adagio</ti tre> 
<effectif> 

<basseContinue/> 
<violons/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Presto Recit de basse</titre> 
<effectif> 
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<tutti/> 
<orgue/> 
</effecti'f> 
</mouvement> 
</sonate> 

<!-- autres sonates a suivre ici --> 
</sonates> 

Le principe pour real i ser la transformation est tres simple: on instancie une <piage>, 
puis tout de suite apres, on instancie les attributs qui sont associes a cette <piage>, puis 
enfin on instancie letitre de la plage : 

<pl age> 

<xsl :apply-templates select="effectif" /> 
<xsl :val ue-of sel ect="titre" /> 
</pl age> 

C 'est I 'instruction : 

<xsl :apply-templates select="effectif" /> 

qui va instancier les attributs necessaires au fur et a mesure que les elements contenus 
dans <effectif> sont decouverts. 

Comment? 

La regie (par defaut) : 

<xsl :template match="effectif "> 

<xsl :apply-templates /> 
</xsl :templ ate> 

va relancer la recherche de motif sur les elements enfants de <effectif> ; on va done 
ecrire une regie par enfant possible. Par exemple, pour I'element <basseContinue/>, on 
va avoir la regie : 

<xsl :template match="basseContinue"> 

<xsl :cal 1 -tempi ate name="bc"/> 
</xsl :template> 

ce qui aura pour effet d'instancier tous les attributs regroupes dans le modele nomme 
« be ». 

II suffit done d'ecrire une regie comme celle-ci pour chaque element possible enfant de 
<effectif>. On voit la souplesse que cela procure : si on enleve ou ajoute un element 
dans la description de I'effectif, il n'y a rien a changer dans le programme XSLT. Dans la 
solution precedente, cela n'aurait pas ete necessairement vrai : si I'ajout ou la suppres- 
sion avaitfait retomber sur unecombinaison deja utilisee par ailleurs, il n'y aurait rien eu 
a changer ; mais sinon, il aurait fallu ajouter un <xsi :when> dans le <xsi :choose>, cor- 
respondent a la nouvellecombinaison. 
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Si maintenant on invente une nouvelle categorie (par exemple <vents>, regroupant une 
flute et un hautbois), il y a juste a ajouter une regie : 

<xsl :templ ate match="vents"> 

<xsl :call-template name="fl hb"/> 
</xsl :templ ate> 

et a creer le regroupement d'attri buts correspondant : 

<xsl :templ ate name="fl hb"> 

<xsl :attribute name="fl ">xxx</xsl :attribute> 
<xsl :attribute name="hb">yyy</xsl :attribute> 
</xsl :templ ate> 

Le programme est done finalement celui-ci : 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding='IS0-8859-l' /> 



<xsl : tempi ate name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 
<xsl :attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 

</xsl :templ ate> 

<xsl :templ ate name="vls"> 

<xsl attribute name="vl l">fmrt</xsl 
<xsl attribute name="vl 2">oded</xsl 

</xsl :templ ate> 

<xsl : tempi ate name="tt"> 

<xsl :call-template name="bc"/> 

<xsl :call-template name="vl s"/> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :templ ate> 



:attribute> 
:attribute> 



<xsl :templ ate match="/"> 

<pl ages> 

<xsl : apply-templ ates/> 

</pl ages> 
</xsl rtempl ate> 

<xsl : tempi ate match="sonate"> 

<xsl :for-each select="mouvement"> 
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<pl age> 

<xsl :apply-templates select="effectif" /> 
<xsl :val ue-of select="titre" /> 
</pl age> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="basseContinue"> 

<xsl :cal 1 -tempi ate name="bc"/> 
</xsl :templ ate> 

<xsl : tempi ate match="violons"> 

<xsl :call-template name="vls"/> 
</xsl :templ ate> 

<xsl : tempi ate match="tutti "> 

<xsl :cal 1 -tempi ate name="tt"/> 
</xsl :templ ate> 

<xsl :template match="orgue"> 

<xsl :attribute name="org">fech</xsl :attribute> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Le resultat obtenu est exactement le meme qu'auparavant (voir fichier pi agesCD.xmi a la 
section Exemple, page 307). 



Note 

Ne trouvez-vous pas que ces plages de CD manquent terriblement de numeros ? Cela viendra ... (voir Calcul 
d lin numero d'ordre, page 349). 



Complements 

II y a un certain nombre de regies associees a I'utilisation d'un groupement d'attri buts 
par I'instruction xsi :attribute-set. En effet, ayant compris I'utilisation de cette ins- 
truction dans un cadre general, oil tout marchecomme sur des roulettes, on en vienttout 
naturel lement a se poser des questions angoissees sur le comportement de X SLT vis a vis 
detel outel caslimiteou pathologique qui pourraittres bien seproduire. 

Question 

Soitun element XML en cours d'instanciation dans le document resultat. On suppose que cet element possede 
deja un attributde nom t , etque dans la suite de I'instanciation, on decouvre a nouveau un attributde nom ta 
ajouter a cet element. Est-ce une erreur ? 
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Non, ce n'est pas une erreur. Le dernier ajoute I'emporte. Et c'est meme une technique 
classique pour surcharger un ajout d'attribut : 

<xsl :when test="@effectif = 'bc-violons' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :attribute name="vl l">xxx</xsl :attribute> 
<xsl :value-of select="titre"/> 
</pl age> 
</xsl :when> 

Danscetexemple, on veut que final ement, soit ajoute a I 'element <piage> un attri but vii 
qui n'ait pas sa valeur « normale », mais la valeur « xxx ». On ajoute done tous les attri - 
buts correspondant a 'bc-vioions', eton ecrase I 'attri but vi 1 avec un nouvel attri but de 
meme nom, mais ayant une valeur differente. 

Question 

Soit deux attribute-set different, mettons A et B, references dans un appel d'attribute-set, comme 
ceci : use-attribute-sets="A B". Que se passe-t-il si on trouve un attributx dans A et un attributy dans B 
qui ontle meme nom ? 

Ici la reponse est que I 'ordre d'ajout des attri buts est impose par I 'enumeration des noms 
d'attribute-set dans la liste : use-attribute-sets="A b" implique d'abord I'ajoutdes 
attri buts deA, puis ceux deB. On est done ramene au cas precedent : en cas de conflit de 
nom, le dernier ajoute ecrase le malheureux qui etait deja au chaud. 

Question 

Que se passe-t-il si on trouve deux attribute-set de meme nom ? Est-ce une erreur? 

Non, ce n'est pas une erreur en general. Les deux attribute-set sont tout simplement 
fusionnes, e'est-a-dire que les attri buts de I'un sont mis dans I'autre. Du coup on peut 
retomber sur un probleme de conflit de noms d'attribut en effectuant cette fusion. M ais 
cette fois le cas est plus grave, car il peut ne pas y avoir de critere valable pour decider 
lequel I'emporte sur I'autre. Si rien ne permet de trancher, c'est une erreur, mais le pro- 
cesseur XSLT n'est pas oblige de la signaler, et peut eventuellement se contenter de se 
baser sur I'ordre d'apparition des attribute-set dans le document pour determiner un 
vainqueur. 

Note 

Mais il peut aussi y avoir un critere, base parexemple sur la precedence relative d'un attribute-set par rapport a 
I'autre, dans le cas d'une importation par <xsl:import> que I'on verra un peu plus loin (voir Instruction xskimport, 
page 381). 

Vous voyez qu'on est en train de s'enliser dans des problemes a n'en plus finir, qui sont 
dusacequeles regies sont tres souplesettres« coulantes», cequi fait que denombreux 
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problemes surgissent. A chaquefois, s'il y a une solution pours'en sortir, on I'adopteet 
on en fait une regie. M ais ceci interesse les gens qui doivent ecrire un processeur XSLT, 
etbeaucoup moinsceux qui doivent s'en servir, parcequ'il estbien raredesemettresoi- 
meme dans de pareilles situations. 

De plus, tous ces problemes disparaissent si on adopte la technique des modeles nommes 
pour fai redes regroupements d'attributs, au lieu d'utiliser les attribute-set, commeci- 
dessus. D'ou la question : 

Question 

Peut-on prendre le parti d'ignorer completement la notion d'attribute-set, et d'utiliser a la place celle de 
modele nomme regroupantdes attribute ? 

Helas, non. D'abord parcequevous pouvez tomber sur des feui lies de style qui utilisent 
les attribute-set ; il faut done comprendre a quoi ils servent et comment ils inter- 
viennent. Ensuite, parcequ'il y a unechosequ'il est impossible de fai re avec les modeles 
nommes, c'est d'importer (par I'instruction <xsi :import>, que nous verrons plus loin, a 
la section Instruction xsl : import, page 381) deux groupements d'attributs provenant de 
deux feui 1 1 es de style differentes, de telle sorte que cela se traduise par une fusion des 
deux groupements. (Avec deux modeles nommes importes et de meme nom, au mieux 
I'un des deux sera ignore, et au pi re, il y aura une erreur fatal e : la fusion de modeles 
nommes n'a aucun sens). Or la technique d'importation de feui I les de style est extreme- 
ment importante, car el I e permet de modulariser et de reutiliser. 

Ceci n'empeche evidemment pas d'employer la technique des modeles nommes pour 
fai re des regroupements d'attributs, qui reste parfaitementvalideen general. Maisil y a 
des cas ou on peut avoir reel I ement besoin d'utiliser de vrais attribute-set. 

Instruction xshcopy 

Remarque 

instruction xsl :copy n'estpas une instruction de creation commexsl : el ement ou xsl attribute, puisque 
c'est une instruction qui permet de recopier un fragment du document source vers le document resultat. Logi- 
quement, il auraitete preferable de la placer aux cotes de I'instruction xsl :copy-of, deja vue il y a assez long- 
temps (voir Instruction xsl:copy-of, page 156). E Me se trouve placee ici pour deux raisons. La premiere, c'est 
qu'elle est equivalente dans certains cas a xsl : el ement, equivalence qui va jusqu'a ('utilisation de I'attribut 
use-attn'bute-sets, et a xsl : attribute dans certains autres cas (mais il y a aussi des cas oil elle ne 
ressemble ni a I'une, ni a I'autre). 

La deuxieme raison est que xsl :copy est une instruction bien plus difficile a manierque xsl :copy-of, etqu'il 
auraitete premature de la presenter a la suite de xsl :copy-of : I'instruction xsl :copy est un instrument de 
precision chirurgicale, qui est a xsl :copy-of ce que le bistouri estau marteau-piqueur. 
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Bande-annonce 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M 

<Compositeur>D 

<Compositeur>F 
</Compositeurs> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' encodings' ISO-8859-1' indent='yes' /> 

<xsl : tempi ate match="/"> 
<Interpretes> 

<xsl : apply-templ ates/> 
</Interpretes> 



. Marais</Compositeur> 
. Castello</Compositeur> 
. Rognoni</Compositeur> 
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</xsl :templ ate> 

<xsl :template match="Interprete"> 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match="Nom"> 

<xsl :copy> 

<xsl :apply-templates mode="copie"/> 

</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="Instrument"> 

<xsl :copy> 

<xsl :apply-templates mode="copie"/> 

</xsl : copy> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 

<xsl : tempi ate match="text( )" mode="copie" > 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 
</Interpretes> 

Le meme resultat au rait ete obtenu en modifiant legerement le programme commececi : 
Concert.xsl 



<<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
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<xsl routput method='xml ' encoding=' ISO-8859-1' indent='yes' /> 



<xsl : tempi ate match=V> 

<Interpretes> 

<xsl :apply-templates/> 

</Interpretes> 
</xsl rtempl ate> 

<xsl :template match=" Interpreted 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl rtempl ate> 

<xsl : tempi ate match="Nom"> 

<xsl :copy> 

<xsl :value-of select="."/> 

</xsl :copy> 
</xsl :templ ate> 

<xsl :template match=" Instrument'^ 

<xsl :copy> 

<xsl : val ue-of select=" . "/> 

</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 



</xsl :stylesheet> 

Syntaxe 

L'instruction xsi :copy permet de creer dans le document resultat une copie du nceud 
courant. 

xsl :copy 

<xsl :Copy> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :copy> 

L'instruction xsi :copy nedoit pas apparaitre en tant qu'instruction de premier niveau. 

Variante syntaxique 

On peut, si I'on veut, ajouter un attribut use-attribute-sets, comme ceci : 
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xsl :copy 

<xsl :copy use-attribute-sets=" . . . "> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :copy> 

Cet attri but n'est pas toujours pris en compte, cela depend de la nature du nceud courant. 
N ous verrons cela au cas par cas, dans la suite. 



Semantique 

M erne si dans tous les cas, il s'agit d'une copie, I'effet exact de instruction xsi :copy 
depend dela naturedu nceud courant. Les cas les plus frequents d'utilisation sontlacopie 
d'elements ou d'attributs, mais tous les autres types de nceuds (root, text, namespace, 

processing-instruction, comment) peuvent aUSSi etreCOpieS. 

L'i nStrUCtion xsl :copy peutou non comporter un modele de transformation ; dans la pra- 
tique, on pourra done trouver cette instruction sous deux formes assez typiques. 

Premiere forme : 

<xsl : tempi ate match=" . . . "> 

<!-- modele de transformation --> 

<xsl :copy/> 

<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Deuxieme forme : 

<xsl :template match=" . . . "> 

<!-- modele de transformation --> 

<xsl :copy> 

<!-- modele de transformation propre a xsl:copy --> 

<!-- fin du modele de transformation propre a xsl:copy --> 
</xsl :copy> 

<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Enfin, il est assez frequent, dans la pratique, de trouver desemplois recursifs del 'instruc- 
tion xsi :copy ; ce sont des cas oil le modele de transformation propre a xsi :copy 
contient au moins une instruction xsi :appiy-tempiates, et ou le motif de la regie qui 
comporte I ' i nstructi on xsi : copy ratissetres large : la combinaison deces deux proprietes 
faitqu'il y a de bonnes chances (en fonction delargeur du rateau) pour qu'une recursion 
s'amorce. Nous verrons cela dans un autre chapitre (voir Pattern n°10 - Copie non 
conforme, page 443). 
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Copie d'un nceud de type element 

Sans modele de transformation propre 

L 'element courant, comme tout element, a un nom : I'effet de I'instruction xsi :copy est 
alors decreer un element de meme nom, comme si on avait utilise I'instruction xsi : ele- 
ment pour le creer. S'il y a des declarations de domaines nominaux dans I 'element cou- 
rant, el les sont copiees du meme coup ; mais c'est tout, rien d'autre n'est copie, ni les 
eventuels attributs de I 'element courant, ni seseventuels enfants. 

Voyons cela sur un exemple; nous reprenons le fichier XML obtenu comme resultat 
du programme XSLT montre a la section Exemple avec namespace="...", page 301. 
Ce fichier resultat etait le suivant : 

interventionsRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 

Le Tableau de 1' Operation de la Taille 

</prologue> 

<mesure xmlns:ns0=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="l"> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="8"> 

Fremissement en le voyant.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="ll"> 

Resolution pour y monter.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="15"> 

Parvenu jusqu'au hault;</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="20"> 

descente dudit apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="22"> 

Reflexions serieuses.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="23"> 

Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="27"> 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="31"> 

Introduction de la tenette.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="39"> 

Ici l'on tire la piere.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="44"> 

Icy l'on perd quasi la voix.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="48"> 

Ecoulement du sang.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="50"> 

Icy l'on oste les soyes. </mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="53"> 

Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 
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Lecontenu dece fichier n'a aucune importance ; la seule chose qui compteici, estqu'il 
y a des elements avec une declaration dedomaine nominal, un attri but, et un enfant direct 
(un nceud de type text, en I 'occurrence). 

On va done les copier, et voir cequ'il en reste apres copie. Le programme XSLT esttres 
simple : 

copie .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl :template match="mesure"> 

<xsl :copy/> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 



<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de 


gambe"/> 



</mesures> 

Le resultat confirme bien ce qui etait annonce plus haut: I 'element courant, lors de 
I'instanciation du modele de transformation associe a la regie <xsi :tempiate match= 
"mesure">, donne son nom et ses domaines nominaux a un nouvel element cree dans le 



Les instructions de creation 

Chapitre 6 



document resultat, mais nedonnerien d'autreautomatiquement : I'attribut nsO:No=". . . ■ 
a disparu, et letexteassocie aussi, cequi fait que I 'element ainsi cree se retrouve vide. 

Avec modele de transformation propre 

Si I'instruction xsi :copy possede en propre un modele de transformation, tout se passe 
d'abord comme s'il n'y en avait pas. Done, comme explique ci-dessus, il y a creation 
d'un element de meme nom, et de memes domaines nominaux. U ne fois I'element ainsi 
cree, le modele de transformation local est instancie, cequi a poureffetdecreerdesnou- 
veaux nceuds(qui peuvent etre de type text, element, attribute, comment, etc.) qui vont 
etre rattaches a I'element precedemment cree. 

On voit done ce qui va se passer : supposons par exemple que le modele de transforma- 
tion comporte seulement un nceud texte, ce dernier va etre instancie et attache a son 
parent dans un lien parent-enfant. 

Exemple : 

<xsl : tempi ate match="mesure"> 

<xsl :copy> 

texte sur mesure 

</xsl :copy> 
</xsl :templ ate> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe"> 

texte sur mesure 
</mesure> 

<mesure xml ns :nsO="http: //concerts. anacreon .fr/viol e-de-gambe"> 

texte sur mesure 
</mesure> 
<!-- etc. --> 
</mesures> 

Si maintenant le modele de transformation comporte une instruction xsl : attri bute, 
comme ceci : 

<xsl : tempi ate match="mesure"> 
<xsl :copy> 

<xsl attribute name="No">23</xsl :attribute> 
</xsl :copy> 
</xsl :templ ate> 

ce sera cette fois un attribut qui sera attache a I'element : 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe" No="23"/> 
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<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" No="23"/> 
<!-- etc. --> 
</mesures> 

Au fait, on a perdu le domaine nominal de I'attribut "No" dans la bagarre. Comment le 
faire reapparaitre ? En realite, ce n'est pas un problemelie a I'instruction xsi :copy, mais 
a xsi attribute. II faut ici utiliser la variante syntaxique avec attri but namespace=" ..." 
(voirVariante syntaxique namespace="...", page 300). 

De plus, il faudra utiliser un descripteur de valeur differee d' attri but, qui est autorisee 
pour cet attri but, et fournir une expression XPath qui soit egale au domaine nominal 
"nsO". Ce n'est pas le genre d'expression XPath qu'on manipuletres souvent, il est done 
preferable ici de rappeler qu'on la construit comme une expression donnant un attri but, 
mais avec I'axede localisation "namespace: : " au lieu de "attribute::". 

<xsl : tempi ate match="mesure"> 
<xsl :copy> 

<xsl attribute name="No" namespace="{namespace: :ns0}">23</xsl :attribute> 
</xsl :copy> 
</xsl : tempi ate> 

Ici, on reclame pour I'attribut No un domaine nominal qui soit le namespace connu sous 
I'abreviation nso. 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"/> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"/> 
<!-- etc. --> 
</mesures> 

A titrede curiosite, voici les del ires qu'on aurait obtenus si on avait omis la notation des 
descri pteurs de valeurs differees d' attri but : 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl attribute name="No" namespace="namespace: :ns0">23</xsl :attribute> 
</xsl :copy> 
</xsl : tempi ate> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xmlns:ns0.6=" namespace: :nsO" ns0.6:No="23"/> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xmlns:ns0.6=" namespace: :nsO" ns0.6:No="23"/> 
<!-- etc. --> 
</mesures> 
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Ou bien si on s'etait dit que le domaine nominal, c'etait « nsO », et qu'on pouvait done 
indiquer directementcettevaleur : 

<xsl :templ ate match="mesure"> 
<xsl :copy> 

<xsl :attribute name="No" namespace="ns0">23</xsl :attribute> 
</xsl :copy> 
</xsl :templ ate> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts. anacreon .fr/viol e-de-gambe" 

xml ns :nsO. 6="ns0" ns0.6: No="23"/> 
<mesure xml ns :nsO="http: //concerts. anacreon .fr/viol e-de-gambe" 

xmlns:ns0.6="ns0" ns0.6:No="23"/> 
<!-- etc. --> 
</mesures> 

Dans ces deux cas, la valeur fournie dans I 'attri but namespace=" ..." est prise pOUT une 
chaine de caracteres decrivant un nouveau domaine nominal. Normalement, une telle 
chaine a la forme d'une URL (http://etc), mais il n'y aucune verification. Pour que 
cela marche, il faut donner non pas une nouvel I e valeur de domaine nominal, mais une 
valeur existante. 

La valeur existante, C'eSt http://concerts.anacreon.fr/viole-de-gambe, C'eSt-a-dire 

la valeur du pseudo-attribut xmins:nso, commeon peutlevoiren considerant a nouveau 
I'un des elements <mesure> du document source : 

<mesure xml ns:nsO=" http://concerts.anacreon.fr/viol e-de-gambe" 
nsO:No="l"> 
L'aspect de 1 'apareil . 
</mesure> 

Si c'etait un veritable attri but, on le referencerait en ecrivant I 'expression XPath 

"attribute: :xmlns:nsO", de meme qU'On eCMrait I'expreSSiOn "attribute: :nsO:No" 

pour referencer la valeur del 'attri but nsO: No. M aisxmins:nso n'estpasun attri but, meme 
s'il en a la forme. C'est un domaine nominal, ou namespace, que I'on trouve sur I'axede 

localisation namespace: : et non paS attribute: :. 

Or cette expression XPath "namespace: :xmins:nsO" ne peut pas etre placee telle quelle 
comme valeur de I'attribut namespace : 

<xsl attribute name="No" namespace="namespace: :xmlns:ns0">23</xsl :attribute> 

Si on ecrit cela, ce n'est pas une expression XPath qui est fournie comme valeur, mais 
une simple chaine de caracteres sans signification particuliere. Pour que cette chaine soit 
reconnue comme une expression XPath aevaluer, il faut en faire un descripteur de valeur 
differee d' attri but, comme ceci : 

<xsl attribute name="No" namespace="{namespace: :xmlns:ns0}>23</xsl :attribute> 
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Etcettefois, c'estbon ! 

Supposons maintenant qu'on veuille aussi copier le noeud text qui se trouve attache a 
chaque element <mesure> ; il suffit d'ajouter un noeud text de meme valeur dans le 
model e de transformation propre a I 'instruction xsi :copy ; ce noeud text sera alors ins- 
tance, et attache a I 'element <mesure> nouvellement cree avec un lien parent-enfant : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl attribute name="No" namespace="{namespace: :ns0}">23</xsl :attribute> 
<xsl :value-of sel ect=" . "/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

Fremissement en le voyant.</mesure> 
<!-- etc. --> 
</mesures> 

Et pour finir, si I 'on veutquela valeur del 'attri but nesoit pas toujours "23", mais la vraie 
valeur, il suffit de prelever cette vraie valeur et de la fournir a I ' instruction xsi attri- 
bute : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 
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<xsl:output method='xml ' indent="yes" encodings ISO-8859-1' /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl : apply-templ ates/> 

</mesures> 
</xsl :template> 

<xsl : tempi ate match="mesure"> 
<xsl :copy> 

<xsl :attribute name="No" namespace="(namespace: :nsO}"> 

<xsl :value-of select=" attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl : val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

M alheureusement, si I'on essaiecela, on n'obtientqu'un message d'erreur : 

Resultat 

Error on line 17 of copie.xsl: 

Namespace prefix nsO has not been declared 
Transformation failed: Failed to compile stylesheet. 1 error detected. 

En effet, comme le domaine nominal « nsO » intervenient dans cette feuille de style, il 
doit etre declare. II est impossibledecontourner cette obligation ; si I'on tente dene pas 
mentionner le domaine nominal, I'expression XPath neselectionne rien du tout : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding='IS0-8859-l' /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl : apply-templ ates/> 

</mesures> 
</xsl :template> 

<xsl : tempi ate match="mesure"> 
<xsl :copy> 

<xsl :attribute name="No" namespace="(namespace: :nsO}"> 

<xsl :value-of select="attribute: :No"/> 
</xsl :attribute> 
<xsl : val ue-of select="."/> 



Instruction xshcopy 

Chapitre 6 

</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No=""> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No=""> 

Fremissement en le voyant.</mesure> 
<!-- etc. --> 
</mesures> 

La seule solution est done de declarer ce domaine nominal : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1' /> 

<xsl :template match="/"> 

<mesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl attribute name="No" namespace="{namespace: :nsO}"> 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesures xmlns :nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 
<mesure nsO:No="l">L'aspect de 1 'apareil .</mesure> 
<mesure nsO: No="8">Fremi ssement en le voyant.</mesure> 
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<mesure nsO:No="ll">Resolution pour y monter.</mesure> 
<mesure nsO:No="15">Parvenu jusqu'au hault;</mesure> 
<mesure nsO:No="20">descente dudit apareil .</mesure> 
<mesure nsO:No="22">Reflexions serieuses.</mesure> 
<!-- etc. --> 
</mesures> 

L ' aspect du resultat. 

Fremissement en levoyant. 

Resolution pour y voir plus clair. 

Reflexions serieuses : pourquoi a-t-il change ? 

Soulagement en comprenant que memesi I 'aspect externe a change par rapport a I 'origi- 
nal, la signification XML reste la meme, puisqu'un domaine nominal, declare dans un 
element, est herite par tous ses descendants. 

Note 

Ce n'estpas le seul cas ou I'aspectdu resultat peutne pas correspondre exactementace que I'on attend ;mais 
si la semantique XML estcorrecte, etque la seule chose a changer est I'aspect externe du resultat, ce n'estpas 
certain qu'il soit possible d'y parvenir. Par exemple, si vous n'aimez pas les apostrophes doubles (") pour les 
attributs, etque vous preferez les simples, inutile de chercher, il n'y a aucun moyen de reglerce detail en XSLT. 
Avec di sable-output-escaping (voir section Variante syntaxique, page 260), il est possible d'empecher (dans 
certains cas) la sortie d'entites caracteres, mais si une entite caractere est emise dans le document resultat, 
vous ne pouvez pas choisir, par exemple, entre > et > qui sont considerees comme equivalentes. II est 
vrai que I'esthetique d'un fichier source peut etre d'une certaine importance, au moins pour les personnes sen- 
sibles, etque des versions ulterieures de XSLT permettront peut-etre de mieux prendre en compte les prefe- 
rences de chacun ; mais pour I'instant, quand on n'a pas ce que I'on aime, il faut aimer ce que I'on a. 

Conclusion 

Lorsque le nceud courant a copier est de type ei ement (et dans ce cas seulement), I'ins- 
truction xsi :copy se comporte done comme instruction xsi teiement. Tout ce qui a ete 
vu a propos dexskel ement s' applique done dans ce cas. D'ailleurs, on pourrait tres bien 
recrire le programme copie.xsi dans sa version precedente, en utilisant xsi element au 
lieu de xsi : copy : 

copie.xsi 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method^'xml ' indent="yes" encoding='IS0-8859-l' /> 



<xsl :template match="/"> 
<mesures> 



Instruction xshcopy I 

chap7trF6~M 

<xsl :apply-templates/> 
</mesures> 
</xsl :templ ate> 

<xsl : tempi ate match="inesure"> 
<xsl:element name="mesure"> 

<xsl :attribute name="No" namespace="{namespace: :nsO}"> 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl :val ue-of select="."/> 
</xsl :el ement> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Le resultat obtenu est strictement identique au precedent. 

Cette equivalence entre xsi :copy et xsi : element lors de la copie d'un nceud de type 
element, permet done decomprendre immediatement comment utiliser I 'attri but faculta- 
tif use-attribute-sets : de facon evidente, il s'utilise exactement comme pour I'ins- 
truction xsi :eiement (voir Variante syntaxique use-attri bute-sets=" ..." , page 289). M ais 
encore unefois, ceci n'est vrai que si le nceud a copier est un nceud detype element. 

Copie d'un nceud de type attribute 

L'attri but courant, comme tout attri but, a un nom et une valeur : I'effet de I 'instruction 
xsi :copy est alors de creer un attri but de meme nom et de meme valeur, comme si on 
avait utilise ^instruction xsi attribute (associee au modelede transformation qu'il faut 
pour que ce soit bien la bonne valeur qui soit affectee a l'attri but). Comme la valeur de 
I 'attri but n'est pas modifiable par xsi: copy, un modele de transformation propre a 
xsi :copy ne sert ici a rien. Ce n'est pas uneerreur d'en fournir un, mais il est ignore par 
le processeur XSLT. 

Et comme un attri but ne peut pas avoir d 'attri but, I 'attri but use-attribute-sets est aussi 
ignore, si jamais il estfourni. 

Les memes problemes deja rencontres pour xsi attribute surviennent ici : si on essaye 
de creer un attri but dans le document resultat, alors que le nceud destinataire n'est pas de 
type element, c'est une erreur fatal e. Par contre I'ajout de plusieurs attri buts de meme 
nom n'en n'est pas une : c'est le dernier ajoute qui I'emporte (n'oublions pas la regie du 
pape, voir Se'mantique, page 293). 

Pour illustrer ceci, reprenonsl'exempledu fichier XML decrivantdes plages de CD (voir 
Exemple, page 307), etvoyonsle programme XSLT capable delereprodui re a I 'identique. 

Le fichier de depart est eel ui-ci : 

plagesCD.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 
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<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded" org="fech"> 



Grave 
</pl age> 



Presto 
</pl age> 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded" vlc="dsmp"> 
/ Prestissimo 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded"> 



Adagio 
</pl age> 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 



vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Et voici le programme de copie : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xs1 :stylesheet 

xml ns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding=' ISO-8859-1' /> 

<xsl :templ ate match="/"> 

<pl ages> 

<xsl : apply-templ ates/> 

</pl ages> 
</xsl :templ ate> 

<xsl :templ ate match="pl age"> 
<xsl :copy> 

<xsl :for-each select="attribute: :*"> 

<xsl :copy/> 
</xsl :for-each> 
<xsl :value-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

</xsl :stylesheet> 

Pour chaque <piage> rencontree, on cree un element de meme nom par instruction 
<xsi : copy>, auquel on accroche autant d'attri buts qu'on en trouve dans I 'element origi nal . 
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Explorer I 'ensemble des attributs decet element original peut sefaire par une instruction 
xsi : for-each qui selectionne tout ce qui est attri but du nceud courant. Le modele de 
transformation de xsi :for-each ne contient qu'une seule instruction, qui va etre instan- 
ciee avec un noeud courant qui est un attri but. Comme cette instruction est instruction 
xsi :copy, c'est un attri but qui va etre cree avec le meme nom et la meme valeur que 
I 'attri but courant. Ensuite, cet attri but sera ajoute a I'element courant (une <piage>, en 
I'occurrence). 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" vl2="oded" 
org="fech">Grave</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" vl2="oded" 
vcl ="dsmp">Presto / Prestissimo</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" vl2="oded">Adagio</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" vl2="oded" 
vcl="dsmp" org="fech">Presto Recit de basse</pl age> 

</pl ages> 

La presentation n'est pas la meme que celle du fichier de depart, mais on sait qu'il n'y a 
pas grand chose a faire (voir section Avec module de transformation propre, page 328). 

Une autre facon deproceder, assez classique, serait celle ci : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml ' indent="yes" encodings' ISO-8859-1' /> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl :templ ate> 

<xsl :template match="pl age"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 
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<xsl : tempi ate match=" attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

A u lieu d'utiliser un xsi :for-each pour explorer chaque attri but, on relancele moteur de 
recherche de concordance de motifs en lui faisant traiter une liste de nceuds qui ne 
contient que les nceuds detype attribute attaches au nceud courant. On ajoutealors une 
regie, dont le motif Concorde avec n'importe quel nceud detype attribute : cette regie 
sera done selectionnee par la recherche de concordance dont on vient de parler, et son 
application se traduit par une copie de I 'attri but courant. 

Le resultat est exactement le meme que dans la version precedente. 
Copie d'un nceud de type namespace 

Les choses se passent a peu pres comme dans le cas d'un attri but, car e'est vrai qu'un 
domaine nominal est assez semblable a un attri but. Le modele de transformation est 
ignore, s'il existe, de meme que I 'attri but use-attribute-sets. 

Ledomaine nominal courant, comme tout domaine nominal, a un nom (i.e. le prefixe, ou 
abreviation) et une valeur (i.e. une URL) : I'effet de ^instruction xsi :copy est alors de 
creerun domaine nominal de meme nom etde meme valeur. 

Les memes problemes deja rencontres pour xsi attribute surviennent ici : si on essaye 
decreer un attri but dans le document resultat, alors que le nceud destinataire n'est pas de 
type ei ement, e'est une erreur fatale. 

Attention : la regie du pape ne s'applique pas, ici : e'est une erreur que de vouloir ajou- 
ter un domaine nominal a un element qui en possede deja un de meme nom, sauf si la 
valeur est la meme que eel ledu doublon, auquel cas lenouveau domaine nominal est tout 
simplement ignore. 

La copie de domaines nominaux doit etre terminee avant tout ajout d'attri but ou d'ele- 
mentfils a I 'el ement parent, sinon, e'est une erreur fatale. 

En consequence, il est impossible de copier un element, puis son domaine nominal : en 
effet, la copie d'un element entraine automatiquement eel I e de ses domaines nominaux. 
Nous allons done proceder d'une maniere legerement differente, pour ill ustrer la copie de 
domaines nominaux a travers un exemple. 

Nous prendrons le fichier qui nous a deja servi plusieurs fois : 
taille.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesures xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 

<mesure nsO:No="l">L'aspect de 1 'apareil .</mesure> 

<mesure nsO:No="8">Fremissement en le voyant.</mesure> 

<!-- etc. --> 
</mesures> 
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Voici un programme de copie : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 
<paroles> 

<xsl :for-each select="child: :mesures/namespace: :*"> 

<xsl :copy/> 
</xsl :for-each> 
</paroles> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<pa roles xmlns :nsO="http: //concerts. anacreon.fr/viole-de-gambe"/> 

lei la copie cree un domaine nominal de nom nso et de valeur : 

http: //concerts .anacreon.fr/viol e-de-gambe 

puisque le nceud courant est un domaine nominal, grace au xsi : for-eacn. Ce domaine 
nominal estajouteal'element<paroies>, c'est-a-dire celui qui est en cours de creation. 

Copie du nceud de type root 

Si le nceud courant lors de I 'execution de I 'instruction xsi :copy est le nceud root, le 
model ede transformation associe a xsi :copy, s'il y en a un, est instancie. M ais la racine 
n'est pas copiee, parce que la racine de I'arbre X M L du resultat est toujours creee auto- 
matiquement, au debut du traitement, et qu'il ne s'agirait pas d'en creer une deuxieme. 
Un eventuel attri but use-attribute-sets est bien sflr ignore. 

Prenons par exemple le programme X SLT suivant : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsi =" http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml' indent="yes" encodings' ISO-8859-1' /> 
<xsl :template match="/"> 
<xsl :copy> 



Les instructions de creation 

Chapitre 6 



<truc> 

abed 
</truc> 
</xsl :copy> 

</xsl :template> 

</xsl :stylesheet> 

Quel que soit le fichi er X M L donne, le resultat est le suivant : 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<truc> 

abed 
</truc> 

On voit bien qu'effectivement I 'instruction xsi :copy en elle-meme est inutile, et qu'on 
aurait pu negarder que lemodelede transformation associe, cequi aurait donne lememe 
resultat. 

Copie d'un noeud de type text 

Le texte est copie dans le document resultat. Le modele de transformation de xsl : copy 
est ignore, ainsi que I ' attri but use-attribute-sets. 

Copie d'un nceud de type comment 

Le commentaire est copie dans le document resultat. Le modele de transformation de 

xsl :copy est ignore, ainsi que I ' attri but use-attribute-sets. 

Copie d'un nceud de type processing-instruction 

La processing-instruction est copiee dans le document resultat. Lemodelede transforma- 
tion dexsi :copy est ignore, ainsi que I 'attri but use-attribute-sets. 

Instruction xshcomment 

Syntaxe 

L'inStruCtion xsl:comment permet de creer un commentaire XML dans le document 
resultat. 

xsl : comment 

<xsl :comment> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :comment> 

L'instruction xsi : comment ne doit pas apparaitre en tant qu'instruction de premier niveau. 
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Semantique 

L'instanciation du modele de transformation de instruction xsi : comment ne doit pas 
creer autre chose que des nceuds de type text ; sinon c'est une erreur. C'est aussi une 
erreur que ces nceuds textes contiennent des sequences de caracteres interdites dans un 
commentaireXM L (comme par exemple la sequence •--•). 

II est bien sflr impossible de creer un commentaire dans le document resultat autrement 
que par I 'instruction xsi: comment ; la presence d'un commentaire dans un element 
source litteral est notamment sans effet sur le resultat, puisqu'un tel commentaire est 
ignore par le processeur X SLT. 



Exemple 

Une utilisation interessante des commentaires XML generes par un programme XSLT 
est de tracer I'activation des regies du programme lorsqu'il y a un probleme, pour en 
comprendre I'origine. Pour voir ce que eel a donne, nous reprenons le programme vu a la 
section Exemple, page 170, en placant une instruction xsi :comment dans chaque regie : 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='html ' encodings ISO-8859-1' /> 

<xsl :strip-space elements='Compositeurs'/> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl :value-of select="/Concert/Entete"/X/title> 
</head> 

<body bgcol or="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :templ ate> 

<xsl :template match="Entete"> 
<xsl :comment> 

<xsl :text>dans Entete : </xsl :textXxsl : val ue-of sel ect=" . "/> 
</xsl :comment> 

<p> <xsl : val ue-of select="."/> presentent </p> 
</xsl :templ ate> 

<xsl :template match="Date"> 
<xsl :comment> 

<xsl :text>dans Date : </xsl :text><xsl :value-of select="."/> 
</xsl :comment> 

<H1 align="center"> Concert du <xsl :value-of sel ect=" . "/> </Hl> 
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</xsl :templ ate> 

<xsl : tempi ate match="Lieu"> 
<xsl :comment> 

<xsl :text>dans Lieu : </xsl :text><xsl :val ue-of select="."/> 
</xsl :comment> 

<H4 al ign="center"> <xsl : val ue-of select="."/> </H4> 
</xsl :template> 

<xsl : tempi ate match="Ensemble"> 
<xsl :comment> 

<xsl :text>dans Ensemble : </xsl :text><xsl :val ue-of sel ect=" . "/> 
</xsl :comment> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl :template match="Compositeurs"> 
<xsl :comment> 

<xsl :text>dans Compositeurs : </xsl :text><xsl :val ue-of sel ect=" . "/> 
</xsl :comment> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :apply-templates/> </H3> 
</xsl :template> 

<xsl :template match="Compositeur"> 
<xsl :comment> 

<xsl :text>dans Compositeur : </xsl :text><xsl :value-of select="."/> 
</xsl :comment> 

<xsl :value-of select="."/> 

<xsl:if test="not(position( ) = last())">, </xsl:if> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Leresultatobtenu est celui-ci : 

Concert.html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d'Anacréon </title> 
</head> 

<body bgcol or="white" text="bl ack"> 

<!--dans Entete : Les Concerts d'Anacreon --> 

<p> Les Concerts d'Anacréon présentent </p> 

<!--dans Date : Jeudi 17 janvier 2002, 20H30--> 

<H1 align="center"> Concert du Jeudi 17 janvier 2002, 20H30</H1> 

<!--dans Lieu : Chapel 1 e des Ursules--> 
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<H4 align="center">Chapelle des Ursules</H4> 
<!--dans Ensemble : "A deux violes esgales" --> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
<!--dans Compositeurs : M. MaraisD. CastelloF. Rognoni--> 
<H3 al ign="center"> Oeuvres de <br> 

<!--dans Compositeur : M. Marais-->M. Marais, 
<!--dans Compositeur : D. Castel 1 o-->D. Castello. 
<!--dans Compositeur : F. Rognoni-->F. Rognoni 
</H3> 
</body> 
</html> 

Instruction xshprocessing-instruction 

Syntaxe 

L'instruction xsi :processing-instruction permet de creer une processing-instruction 
XML dans le document resultat. 

xsi :processing-instruction 

<xsl :processing-instruction name=". . ."> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :processing-instruction> 

L'instruction xsi :processing-instruction ne doit pas apparaitre en tant qu' instruction 
de premier niveau. 

Semantique 

L'instanciation du modele de transformation de l'instruction xsi :processing-instruc- 
tion ne doit pas creer autre chose que des nceuds de type text ; sinon c'est une erreur. 
C'est aussi une erreur que ces nceuds textes contiennent des sequences de caracteres 
interdites dans une processing-instruction XML (comme par exemple la sequence 
"?>-). 

Les processing-instructions ne sont pas tres utiliseesen XM L, aussi n'est-il pas facile de 
donner un exemple facilement testable. La processing-instruction la plus courante 
reste eel le qui s'adresse a un navi gateur pour lui indiquer la feuille de style a utili ser pour 
afficher le fichier XML recu. 

Une autre utilisation, plus originale, et qui peut donner des idees, est eel le qui en faite 
dans X M etal (www.softquad.com/), un editeur de fichiers sources XML. Ayant declare une 
DTD pour I e fichier a editer, X M etal propose defacon contextuelle une palette de balises 
possibles a inserer la ou se trouve place le curseur. Avec une DTD comme eel I e de doc- 
book, par exemple, on peut vouloir inserer a tel endroit un nouveau <para>, qui est I 'ele- 
ment representant un paragraphe. 
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Note 

Docbook (http://docbook.org/) est une DTD associee a des feuilles de style XS LT pour rediger des articles, des 
livres, et plus generalement de la documentation. Les feuilles de style XSLT produisent du HTML ou du FO 
(lequel donne du PS ou du PDF avec des processeurs FO adequats). 

X M etal reagit alors en creant non pas un element <para> vide, comme ceci : 

<para></para> 

mais en creant un element contenant une processing-instruction : 

<para><?xm-repl ace- text {para}?X/para> 

L a difference est qu'un element vi de apparait comme tout autre element, alors qu'un ele- 
ment COntenant la processing-instruction <?xm-repl ace-text {para}?> apparait 

avec letexte {para} en blanc surfond noir, cequi lerend particul ierement visible. 

Rien n'empecherait done d'imaginer la production, par une feuille de style XSLT, d'un 
fichier XML qui serait incomplet, mais a completer a la main sous XM etal, les zones a 
remplir etant mises en evidence par des balises <?xm-repi ace-text {para}?>. 

instruction XSLT pour generer une telle balise serait la suivante : 

<xsl :processing-instruction name="xm-replace-text"> 

<xsl:text> {para}</xsl :text> 
</xsl :processing-instruction> 

Instruction xshnumber 

L'instruction xsi number est une instruction dont I'instanciation produit un numero. En 
ce sens, e'est une instruction de creation, puisqu'on peut supposer que ce numero 
n'existe pas en tant que tel dans la source XM L. M ais e'est vrai aussi que s'il n'y a pas 
de source XM L, il n'y a rien a numeroter ; et s'il n'y a rien a numeroter, il n'y a pas de 
numero. On peut done contester ajustetitrequexsi : number soit une instruction de crea- 
tion a proprement parler. 

Bande-annonce 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<maisons> 

<maison id="l"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 



Instruction xshnumber 

Chapitre 6 



Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 
Bibl iotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palmier en zinc figurant le desert. </terrasse> 
<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='l'> 
Lambri s . 

</al cove> 
</chambre> 

<chambre surface='18m2'> 

Lambri s . 
</chambre> 

<salleDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="2"> 
<RDC> 

<cuisine surface='12m2'> 

en ruine. 
</cuisine> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

vue sur la mer 
</terrasse> 

<salleDeBains surface='15m2'> 

Douche. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="3"> 
<RDC> 

<sejour surface='40m2'> 
paillasson a 1 'entree 

</sejour> 
</RDC> 
<etage> 

<chambre surface='18m2'> 
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porte cochere. 
</chambre> 
</etage> 
</maison> 
</maisons> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl routput method='xml' encodings' ISO-8859-1' indent='yes' /> 

<xsl : tempi ate match="*"> 

<xsl :el ement name=" {local -name( . ) } "> 
<xsl attribute name="numero"> 

<xsl:number count="*" level="multiple"/> 
</xsl :attribute> 
<xsl : apply-templ ates/> 
</xsl :element> 
</xsl :templ ate> 



<xsl : tempi ate match="text( ) "/> 



</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison numero="l.l"> 
<RDC numero="l.l.l"> 

<cuisine numero="l.l.l.l"/> 
<WC numero="1.1.1.2"/> 
<sejour num6ro="1.1.1.3"/> 
<bureau numero="l . 1 . 1 .4"/> 
<garage numero="1.1.1.5'7> 
</RDC> 

<etage numero="1.1.2"> 

<terrasse numero="1.1.2.1"/> 
<chambre numero="1.1.2.2"> 

<alcove numero="1.1.2.2.1"/> 
</chambre> 

<chambre numero="1.1.2.3"/> 
<salleDeBains numero="1.1.2.4"/> 
</etage> 
</maison> 

<maison numero="l . 2"> 

<RDC numero="1.2.1"> 

<cuisine numero="1.2.1.1"/> 
<garage numero="1.2.1.2"/> 

</RDC> 
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<etage numero="1.2.2"> 

<terrasse numero="1.2.2.1"/> 

<salleDeBains numero="1.2.2.2"/> 
</etage> 
</mai son> 

<maison numero="l .3"> 
<RDC numero="1.3.1"> 

<sejour numero="1.3.1.1"/> 

</RDC> 

<etage numero="1.3.2"> 

<chambre numero="1.3.2.1'7> 
</etage> 
</mai son> 
</maisons> 

Variante 

<xsl :number count="*" 1 evel ="any"/> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison numero="2"> 
<RDC numero="3"> 

<cuisine numero="4"/> 
<WC numero="5"/> 
<sejour numero= n 6"/> 
<bureau numero="7"/> 
<garage numero="8"/> 
</RDC> 

<etage numero="9"> 

<terrasse numero="10"/> 
<chambre numero="H"> 

<alcove numero="12"/> 
</chambre> 

<chambre numero="13"/> 
<salleDeBains numero="14"/> 
</etage> 
</mai son> 

<maison numero="15"> 
<RDC numero="16"> 

<cuisine numero="17"/> 

<garage numero="18"/> 
</RDC> 

<etage numero="19"> 

<terrasse numero="20"/> 

<salleDeBains numero="21"/> 
</etage> 
</mai son> 

<maison numero="22"> 
<RDC numero="23"> 
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<sejour numero="24"/> 
</RDC> 

<etage numero="25"> 

<chambre numero="26"/> 
</etage> 
</maison> 
</maisons> 

Variante 

<xsl:number count="*" level="single"/> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison numero="l"> 
<RDC numero="l"> 

<cuisine numero="l"/> 
<WC num§ro="2"7> 
<sejour numero="3"/> 
<bureau numero="4"/> 
<garage numero="5"/> 
</RDC> 

<etage numero="2"> 

<terrasse numero="l"/> 
<chambre numero="2"> 

<alcove numero="l"/> 
</chambre> 

<chambre nLiinero="3 n /> 
<salleDeBains numero="4"/> 
</etage> 
</maison> 

<maison numero="2"> 
<RDC numero="l"> 

<cuisine numero="l"/> 

<garage numero="2"/> 
</RDC> 

<etage numero="2"> 

<terrasse numero="l"/> 
<salleDeBains numero="2"/> 

</etage> 
</maison> 

<maison numero="3"> 
<RDC numero="l"> 

<sejour numero="l"/> 
</RDC> 

<etage numero="2"> 

<chambre numero="r7> 
</etage> 
</maison> 
</maisons> 
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Syntaxe 

xsi :number 



<xsl :number 








1 evel =" . 




<! — 


'single' (par defaut), 'any' ou 'multiple' 


count=" . 




<! — 


motif XPath --> 


from= ". 




<! — 


motif XPath --> 


val ue=" . 




<! — 


expression XPath --> 


format=" 




<! — 


Oune chaine de caracteres --> 


1 ang=" . . 




<! — 


Ocode langue (en, fr, etc.) --> 


1 etter-Vc 


ll ue=" . . . " 


<! — 


^'alphabetic' ou 'traditional' --> 


grouping 


-separator^" . 


." <! — 


Uun caractere --> 


grouping 


-size=" ..." 


<! — 


Oun entier --> 



/> 



Tous ces attributs sont facultatifs. 

Les accolades indiquent les attributs pour lesquels un descripteur de valeur differee est 
autorise. 

L'instruction xsi : number est toujours vide. 

L'instruction xsi number nedoit pas apparaitre en tant qu'instruction de premier niveau. 
Semantique 

L'instanciation de I 'instruction xsi number a deux effets independants : 

• Le premier est decalculer un numero d'ordre pour le nceud courant. 
Danscecas, I'attri but value doit etre absent . 

• Le deuxieme est de formater un numero, afin de lui donner un aspect de numero : 1, 
3.5, A.l, (i ii), V I , etc. 

L'attri but value peut etre absent ; dans cecas le numero formate est le numero d'ordre 
calcule. 

L'attri but value peut etre present ; dans cecas le numero formate est la valeur fournie 
par I'expression XPath, dontlecalcul doitamener une valeur qui puisse etre convert] e 
en entier. 

L'instruction xsi number permet de compter toutes sortes de nceuds (element, comment, 
text, attribute...), mais dans la pratique il bien rare d'avoir a compter autre chose que 
des elements. 

Calcul d'un numero d'ordre 

Prenons par exemple la sequence {X a R ? p p a}. Quel est le numero du dernier element 
de cette sequence ? Tout depend de ce que Ton compte : si I'on compte les lettres, il est 
egal a 6 ; si I'on compteles 'a', il vaut2 ; si I'on compte tout, il vaut7. 

L'attri but count permet de determiner la nature des nceuds qui serontcomptes, et done le 
numero qui sera affecte au nceud courant. 
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En I 'absence d'attri but count, cesontlessemblablesdu nceud courantqui sontcomptes. 
Par exemple, si le nceud courant est un nceud de type text, on compte les text ; si le 
nceud courant est un element <tmc>, on compte les <tmc>. 

Si I'attribut count est present, sa valeur est un motif X Path ; pour calculer le numero du 
nceud courant, le processeur XSLT compte le nombre de nceuds situes avant lui, et qui 
concordent avec ce motif. II est vrai que « situes avant » est une formulation assez 
vague ; la definition precise depend de la valeur de I'attribut level (d'une maniere assez 
complexe), et on pourra la consulter (par curiosite) dans le standard XSLT. Neanmoins, 
cette definition precise est plus utilie a un programmeur real isant un processeur XSLT 
qu'a un programmeur real isant une feui I le de style X SLT. L e programmeur X SLT peut se 
contenter de comprendre les trois styles de numerotation sur un exemple, sans avoir a 
connaitre I'algorithme exact du calcul des numeros ; nous verrons un peu plus loin (voir 
Differents modes de calcul d'un numero d'ordre, page 352) un tel exemple. 

Attention 

Un pointassez important estque le decompte se faittoujours sur un document source XML, c'est-a-dire, en prin- 
cipe, sur le document source XML, II est done possible de lancer le decompte sur un autre document que le 
document source principal, a condition que ce soitun document source, c'est-a-dire un document obtenu par la 
fonction standard documento, ou par la reference a une variable contenantunTST (Temporary Source Tree). 
En consequence, il est impossible de decompter directement des elements du document resultat, mais cela 
reste possible indirectement. II faut d'abord construire, dans une premiere passe, le resultat ou une partie du 
resultat en tantque TST lie a une variable. Dans une deuxieme passe, on instancie des <xsi :number> qui vont 
done porter sur les elements de ce TST (arbre d'un document source), ce qui aura pour effet de produire des 
numerotations relatives a I'ordre des elements tels qu'ils apparaitrontdans le document resultat, etnon tel qu'ils 
apparaissentdans le documentsource. Nous en verrons plus loin un exemple (voir Exemple, page 363). 

Exemple 

Reprenons I'exemple vu a la section Copie d'un nceud de type attribute, page 335 ; il 
s'agissait d'illustrer la recopie d'attri buts en partant de la source XM L suivante : 

plagesCD.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded" org="fech"> 

Grave 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp"> 
Presto / Prestissimo 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
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vl2="oded"> 

Adagio 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Le programme X SLT real isant la copie auquel nous etions arrives est celui-ci : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 
version="1.0°> 

<xsl:output method='xml' indent="yes" encoding='IS0-8859-l' /> 

<xsl : tempi ate match="/"> 
<pl ages> 

<xsl :apply-templates/> 
</pl ages> 
</xsl :templ ate> 

<xsl :template match="pl age"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl : val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Voyons maintenant comment modifier la copie pour ajouter un attri but indiquant le 
numero de plage. C'est extremement simple a faire : il suffit de compter les <piage>, et 
pour chacune, de creer un nouvel attri but contenant la valeur du compteur : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl = "http: //www. w3.org/1999/XSL/Transform" 
version="l .0"> 



<xsl:output method='xml' indent="yes" encodings' ISO-8859-1' /> 
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<xsl :templ ate match="/"> 

<pl ages> 

<xsl : apply-templ ates/> 

</pl ages> 
</xsl :template> 

<xsl : tempi ate match="pl age"> 

<xsl :variable name="numero"Xxsl :number/X/xsl :variable> 
<plage No=" {Snumero} "> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl : val ue-of select="."/> 
</pl age> 
</xsl :template> 

<xsl : tempi ate match=" attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<plages> 

<plage No="l" vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 

vl 2="oded" org="fech">Grave</pl age> 
<plage No="2" thb="eblq" vdg="cplu" clv="nspt" vll="fmrt" 

vl2="oded" vcl ="dsmp">Presto / Prestissimo</plage> 
<plage No="3" vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 

vl 2="oded">Adagio</pl age> 
<plage No="4" thb="eblq" vdg="cplu" clv="nspt" vll="fmrt" 

vl2="oded" vcl="dsmp" org="fech">Presto Recit de basse</pl age> 

</pl ages> 

lei, I 'instruction xsi number setrouvedansun model ede transformation ou lenoeud cou- 
rant est necessai rement une <pi age>, et comme on veut j ustement compter I es <pi age>, i I 
n'y a pas besoin defournir I'attribut count. 

Differents modes de calcul d'un numero d'ordre 

Unefoisqu'on a determine cequ'on voulait compter, il y a plusieurs facons de compter : 
on peut compter sequentiellement (comme dans le cas de plages, ci-dessus), ou on peut 
compter en faisant transparaftre la nature arborescente du document XM L. C 'est I'attri- 
but level qui intervient ici. 

L e pi us si mpl e est de montrer un document arborescent, et de voi r les di fferentes possi bi - 
lites de numerotation de ses elements. 

Nous allons done partir du document suivant, representant un texte structure en sections, 
sous-sections, paragraphes, notes de bas de page et listings de programmes : 
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canevasdoc.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<article lang="fr"> 
<sectl> 

<titre>A</titre> 

<regl e importance="l">RlRlR</regle> 
<sect2> 

<titre>B</titre> 
<para>bbb</para> 
</sect2> 
<sect2> 

<titre>C</titre> 
<sect3> 

<titre>D</titre> 
<para>ddd 

<regle importance="3">R2R2R</regle> 
<note>Nt</note>ddd/ 
<note>Nv</note> 
</para> 
</sect3> 
<sect3> 

<titre>E</titre> 
<para>eee 

<note>Nah</note>eee; 
</para> 

<para>e,e,e</para> 

<regl e importance="l">R3R3R</regle> 

<programl i sting>ay</programl i sting> 

<para>e;e;e</para> 

<programl i sting>bg</programl i sting> 

<para>e!e!e 

<regl e importance="2">R4R4R</regle> 
<note>Naa</note>(eee) 
<note>Nzz</note>[eee] 
<note>NEE</note>(e,e,e) 

</para> 
</sect3> 
<sect3> 

<titre>F</titre> 

<programl i sting>ck</programl i sting> 
</sect3> 
</sect2> 
</sectl> 
<sectl> 

<titre>G</titre> 
<sect2> 

<titre>H</titre> 
<para>hhh</para> 
<para>hhh/ 

<note>Nhx</note>hhh; 
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</para> 
</sect2> 
</sectl> 
</article> 

Voici maintenant le programme que nous allons utiliser pour numeroter ces divers ele- 
ments; hormis ^instruction xsi number proprement dite, le reste du programme, sans 
etre d'un grand interet, est un peu complique, a cause de la mise en page indentee que 
I'on veut obtenir, mais qui n'est pas du tout typique des problemes que I'on se pose 
d'ordinaireen XSLT : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 



<xsl rtempl ate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 
note | program! i sti ng |regle" 
level="any"/>.<xsl :value-of sel ect="name( ) "/> 
<xsl:text> </xsl:text> 
<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :templ ate match="para"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note |programlisting | regie" 1 evel ="any"/> 

<xsl :text>.</xsl :text> 

<xsl :apply-templates mode="inpara"/> 
</xsl :templ ate> 

<xsl :templ ate match="note" mode="inpara"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note |programlisting | regie" 1 evel ="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteNote=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="programlisting"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note |programlisting | regie" 1 evel ="any"/> 
<xsl :text>.</xsl :text> 
<xsl :text>textePrograml isting=</xsl :text> 
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<xsl :val ue-of sel ect=" . "/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="titre"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note | programl i sti ng | regie" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="regl e" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regl e"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note |programlisting | regie" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="text( )" mode="inpara"> 
<xsl : i f test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat (level=« any ») 

l.sectl 

2. texteTitre=A 

3. texteRegle=RlRlR 

4. sect2 

5. texteTitre=B 

6. textePara=bbb 

7.sect2 

8. texteTitre=C 

9. sect3 

10. texteTitre=D 

11. textePara=ddd 
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12. texteRegle=R2R2R 

13. texteNote=Nt textePara=ddd/ 

14. texteNote=Nv 

15.sect3 

16. texteTitre=E 

17. textePara=eee 

18.texteNote=Nah textePara=eee; 

19. textePara=e,e,e 

20. texteRegle=R3R3R 

21 . textePrograml i stingray 

22. textePara=e;e;e 

23. textePrograml isting=bg 

24. textePara=e!e!e 

25. texteRegle=R4R4R 

26. texteNote=Naa textePara=(eee) 

27 . texteNote=Nzz textePara=[eee] 

28. texteNote=NEE textePara=(e,e,e) 

29.sect3 

30. texteTitre=F 

31 . textePrograml i sting=ck 

32.sectl 

33. texteTitre=G 

34. sect2 

35. texteTitre=H 

36. textePara=hhh 

37. textePara=hhh/ 

38.texteNote=Nhx textePara=hhh ; 

Resultat (leve1=« single ») 

l.sectl 

1. texteTitre=A 

2. texteRegle=RlRlR 

3. sect2 

1. texteTitre=B 

2. textePara=bbb 

4. sect2 

1. texteTitre=C 

2. sect3 

1. texteTitre=D 

2. textePara=ddd 

1. texteRegle=R2R2R 

2. texteNote=Nt textePara=ddd/ 

3. texteNote=Nv 
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3.sect3 

1 .texteTitre=E 

2. textePara=eee 

l.texteNote=Nah textePara=eee; 

3. textePara=e,e,e 

4. texteRegle=R3R3R 

5. textePrograml isting=ay 

6. textePara=e;e;e 

7 .textePrograml isting=bg 
8.textePara=e!e!e 



1. texteRegle=R4R4R 

2. texteNote=Naa textePara=(eee) 

3. texteNote=Nzz textePara=[eee] 

4. texteNote=NEE textePara=(e,e,e) 



2.sectl 

1. texteT1tre=G 

2. sect2 

1 . texteTitre=H 

2. textePara=hhh 

3. textePara=hhh/ 



1.1. texteTitre=A 

1.2. texteRegle=RlRlR 

1.3. sect2 

1.3.1. texteTitre=B 

1.3.2. textePara=bbb 

1.4. sect2 

1.4.1. texteTitre=C 

1.4.2. sect3 

1.4.2.1. texteTitre=D 

1.4.2.2. textePara=ddd 

1.4.2.2.1. texteRegle=R2R2R 

1.4.2.2.2. texteNote=Nt textePara=ddd/ 

1.4.2.2.3. texteNote=Nv 

1.4.3. sect3 

1.4.3.1. texteTitre=E 

1.4.3.2. textePara=eee 
1.4.3.2.1.texteNote=Nah textePara=eee; 



4 



sect3 

1. texteTitre=F 

2. textePrograml isting=ck 



l.texteNote=Nhx textePara=hhh; 



Resultat (level=« multiple ») 



l.sectl 
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1.4.3.3. textePara=e,e,e 

1.4.3.4. texteRegle=R3R3R 

1 .4.3. 5. textePrograml isting=ay 

1 .4.3.6. textePara=e;e;e 

1.4.3.7. texteProgramlisting=bg 

1.4.3.8. textePara=e!e!e 

1.4.3.8.1. texteRegle=R4R4R 

1.4.3.8.2. texteNote=Naa textePara=(eee) 

1.4.3.8.3. texteNote=Nzz textePara=[eee] 

1.4.3.8.4. texteNote=NEE textePara=(e,e,e) 

1.4.4. sect3 

1.4.4.1. texteTitre=F 

1.4.4.2. texteProgramlisting=ck 

2.sectl 

2.1. texteTitre=G 

2.2. sect2 

2.2.1. texteTitre=H 

2.2.2. textePara=hhh 

2.2.3. textePara=hhh/ 
2.2.3.1.texteNote=Nhx textePara=hhh ; 

Exemple : numerotation classique pour un livre 

Nous reprenons le meme exemple, mais nous voulons avoir une numerotation classique 
pour un livre : numerotation hierarchique pour les sections, leresten'etant pas numerote, 
sauf les notes de bas de pages qui ont une numerotation sequent] elle non hierarchique. 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl :templ ate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level ="mul tiple"/>.<xsl rvalue -of select="name( )"/> 

<xsl:text> </xsl:text> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :templ ate match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :templ ate> 

<xsl :templ ate match="note" mode="inpara"> 
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<xsl:number count="note" level="any"/> 
<xsl :text>.</xsl :text> 
<xsl :text>texteNote=</xsl :text> 
<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="programlisting"> 

<xsl :text>textePrograml isting=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="regl e" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regl e"> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="text( )" mode="inpara"> 
<xsl : i f test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :val ue-of sel ect=" . "/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 
</xsl :stylesheet> 

Nous avons reduit la portee du decompte : I 'attri but count ne mentionne plus que les ele- 
ments secti, sect2et sect3 ; de pi us nous avons enleve I 'instruction xsi : number des ele- 
ments que nous ne voulons plus compter. Pour les notes de bas de page, nous avons utilise 
la valeur "any" de I ' attri but level afin d 'avoir une numerotation lineaire. Voici le resultat : 



Resultat 

l.sectl 

texteTitre=A 

texteRegle=PJRlR 

l.l.sectZ 

texteTitre=B 
textePara=bbb 
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1.2.sect2 

texteTitre=C 
1.2.1.sect3 

texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 

1. texteNote=Nt textePara=ddd/ 

2. texteNote=Nv 



1.2.2.sect3 

texteTitre=E 
textePara=eee 

3.texteNote=Nah textePara=eee; 



textePara=e,e,e 
texteRegle=R3R3R 
textePrograml i stingray 
textePara=e;e;e 
textePrograml i sti ng=bg 
textePara=e!e!e 

texteRegle=R4R4R 

4. texteNote=Naa textePara=(eee) 

5. texteNote=Nzz textePara=[eee] 

6. texteNote=NEE textePara=(e,e,e) 



1.2.3.sect3 

texteTitre=F 
textePrograml i sting=ck 



2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 



Reinitialisation d'un numero d'ordre 

Un autre probleme est la reinitialisation du numero calcule. Par exemple, il peut arriver, 
pour un livre, que I'on veuille reinitialiser la numerotation des notes de bas de pages a 
chaque nouveau chapitre. 

C'est I'attribut from qui permet cela : sa valeur est un motif XPath, et a chaque fois que 
le noeud courant concordeavec ce motif, la numerotation est rei nitial isee. 

Exemple 

Nous reprenons le meme exemple, mais nous supposons que la numerotation des notes 
doit etre rei nitial isee pour chaque section3 : 
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sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl : tempi ate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="multiple"/>.<xsl :value-of sel ect="name( ) "/> 

<xsl:text> </xsl:text> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :template match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :templ ate> 

<xsl :template match="note" mode="inpara"> 

<xsl:number count="note" f rom="sect3" 1 evel ="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteNote=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="programlisting"> 

<xsl :text>textePrograml isting=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="regl e" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regl e"> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )" mode="inpara"> 
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<xsl :if test="normal ize-space( . )"> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat (from=« sect3 » pour les notes) 

1. sectl 

texteTitre=A 
texteRegle=RlRlR 

1.1. sect2 
texteTitre=B 
textePara=bbb 

1.2. sect2 
texteTitre=C 

1.2.1. sect3 
texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 

1. texteNote=Nt textePara=ddd/ 

2. texteNote=Nv 

1.2.2. sect3 
texteTitre=E 
textePara=eee 

1. texteNote=Nah textePara=eee; 

textePara=e,e,e 
texteRegle=R3R3R 
textePrograml i stingray 
textePara=e;e;e 
textePrograml isting=bg 
textePara=e!e!e 

texteRegle=R4R4R 

2. texteNote=Naa textePara=(eee) 

3. texteNote=Nzz textePara=[eee] 

4. texteNote=NEE textePara=(e,e,e) 

1.2.3. sect3 
texteTitre=F 
textePrograml isting=ck 

2. sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 
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ItextePara=hhh/ 
l.texteNote=Nhx textePara=hhh; 

Numero d'ordre sans decompte 

L'attri but vaiue="...", lorsqu'il est present, permet de fournir soi-meme la valeur du 
numero a instancier. Cela peut notamment servir lorsque I'ordre des elements dans le 
document resultat n'est pas le meme que dans la source X M L . Dans ce cas on peut consti- 
tuerun node-set, puis uti User la fonction positiono pour renseigner l'attri but value. 

Exemple 

Nous reprenons le meme exemple, mais nous supposons maintenant que nous voulons 
indiquer un recapitul atif des regies importantes a la fin du document. On peut faire cela 
tres facilement : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l .0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 



<xsl : tempi ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl :apply-templates select="//regle" mode="recap"/> 
</xsl :templ ate> 

<!-- etc. --> 

<xsl :template match="regle" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regl e"> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :templ ate match="regl e" mode="recap"> 

<xsl:number value="position()"/>. <xsl :value-of select="."/> 

<xsl :text> 
</xsl :text> 

</xsl rtempl ate> 
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<xsl : tempi ate match="text( ) " mode="inpara"> 
<xsl :if test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Regies importantes : 

1. R1R1R 

2. R2R2R 

3. R3R3R 

4. R4R4R 

La ou on voulait en venir, c'est qu'on aimerait de plus que ces regies soient classees par 
ordre d'importance (attribut importance de I 'element <regie>). Du coup, on est dans un 
cas ou I'ordre de ces regies dans le resultat est different de I'ordre de ces memes regies 
dans le document source. 

On est alors oblige de proceder autrement : une solution (mais ce n'est pas la seule : voir 
Nume'ro d 'ordre dans un document source secondaire, page 367) est de constituer un 
node-set contenant les regies triees dans le bon ordre, et fournir nous-memes la numero- 
tation a I 'instruction xsi : number grace a I 'attribut vaiue=" ..." : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl :templ ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regl es importantes : 
</xsl :text> 

<xsl :for-each select="//regle"> 
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<xsl :sort sel ect="@importance'7> 

<xsl:number val ue="position( )"/>. <xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl :template match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="multiple"/>.<xsl :val ue-of sel ect="name( )"/> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<!-- etc. --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Regies importantes : 

1. R1R1R 

2. R3R3R 

3. R4R4R 

4. R2R2R 

Mais peut-etre penserez-vous qu'il n'etait pas necessaire de passer par instruction 
xsi :number pour obtenir ce resultat. C'est vrai que la numerotation est fournie par la 
valeurrenvoyeeparlafonction positiono : alors pourquoi ne pas exploiter cettevaleur 
directement dans une instruction xsi :vai ue-of ? 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl :for-each select="//regle"> 
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<xsl :sort select="@importance"/> 

<xsl :value-of select="position()"/>. <xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :template> 

<!-- etc. --> 

</xsl :stylesheet> 

De fait, ceci fonctionne aussi bien. M ais, en anticipant sur une prochaine section (voir 
Rendu de la nunv'rotation, page 368), on peut tres facilement modifier le rendu de la 
numerotation avec xsi : number, alors qu'avec xsi :vaiue-of, il faut tout programmer a 
la main : 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl : tempi ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regl es importantes : 
</xsl :text> 

<xsl :for-each select="//regle"> 

<xsl :sort select="@importance"/> 

<xsl:number val ue="position( )" format="I"/>. <xsl :val ue-of 

sel ect=" . "/> 

<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<!-- etc. --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre^G 
2.1.sect2 

texteTitre^H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 
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Regies importantes : 

I. R1R1R 

II. R3R3R 

III. R4R4R 

IV. R2R2R 

Numero d'ordre dans un document source secondaire 

Une derniere solution (pour le probleme de la section precedente) consisterait a utiliser 
un TST intermedial re. En effet, on veut numeroter des regies dans I'ordre ou elles appa- 
raissent dans le document resultat. M ais on sait qu'il est impossible de numeroter direc- 
tement des elements qui se trouvent ailleurs que dans un document source. II faut done 
commencer, dans une premiere passe, par constituer un document source secondaire 
(un TST, voir Temporary Source Tree, page 192). Dans ce TST, on place les elements 
a numeroter, dans le bon ordre (celui du resultat vise), en utilisant eventuellement 
<xsi:sort>. Dans une deuxieme passe, le TST etant constitue, on s'en sert comme 
source XM L secondaire ; des lors une instruction <xsi :number> va porter sur cette source 
X M L, et le decompte se fera par rapport a cette source. 

Exemple 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l.l"> <!-- compatibility Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 



<xsl : tempi ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl :variable name="l esRegl es"> 

<xsl :for-each sel ect="//regl e"> 

<xsl :sort select="@importance"/> 
<xsl:copy-of select="."/> 

</xsl :for-each> 

</xsl :vari abl e> 

<xsl :for-each select="$lesRegles//regle"> 

<xsl :number/>. <xsl :val ue-of sel ect=" . "/Xxsl :text> 

</xsl :text> 

</xsl : for-each> 
</xsl rtempl ate> 



<xsl :templ ate match="sectl | sect2 |sect3"> 
<xsl:number count="sectl | sect2 |sect3" 
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level ="mul tiple"/>.<xsl :value-of select="name( )"/> 
<xsl :apply-templates/> 
</xsl :template> 

<!-- etc. comme avant --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Regies importantes : 

1. R1R1R 

2. R3R3R 

3. R4R4R 

4. R2R2R 

Peut-etre vous demandez vous si Ton pouvait faire I'economie de la deuxieme passe, 
c'est-a-dire du deuxieme <xsi :for-each>, en placant directement instruction 
<xsi :number> dans le premier <xsi : for-each>. La reponse est non, car le decompte se 
fait dans le document source courant, pas dans la liste de nceuds temporaire constitute 
par <xsi : for-each> et reordonnee par <xsi :sort>. 

Le modele de transformation du deuxieme <xsi :for-each> est relatif a un document 
source secondai re, reference par la variable lesRegies. Les expressions X Path ou les ins- 
tructions XSLT qui s'y trouvents'appliquentdonc aceTST, etnon au document source 
principal. Les deux passes sontdonc necessaires. 

Rendu de la numerotation 

Un numero de sequence etant calcule ou simplement fourni, on s'interesse maintenant a 
I'aspect exterieur sous lequel il est instance dans le document resultat. Par exemple un 
numero dont la valeur est 4 peut apparaitre sous les formes equivalentes 4, d, D, 004, IV, 
iv, (iv), 4°, IV-, etc. Toutes ces formes sont instanciables directement par instruction 
xsi number, sansqu'il y ait besoin de programmer quoi quecesoit. Cela s'applique bien 
sfir au cas plus complique ou le numero est forme de plusieurs nombres, dans le cas 
d'une numerotation hierarchique (ievei="muitipie") : 1.2.1 pourrait etre renduA.2-a, 
par exemple. 

Le principe est le suivant : on ecrit une chaine de formatage, a peu pres dans le meme 
esprit que cequ'on pourrait faire en C++ou en C avec instruction printf. Cette chaine 
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contient deux types conformations qui doivent alterner dans un ordre quelconque : la 
ponctuation (i.e. les signes divers tels que ". . ')-cetc.) et les caracteres alphanume- 
riques. Ces derniers sont interprets comme des descripteurs de formats de sortie, alors 
que les signes de ponctuation sont pris pour ce qu'ils sont sans interpretation parti culiere. 

^interpretation des descripteurs de format se faitsur la base des conventions suivantes : 

• 1 : pour instancier un numero defacon banale ; 

• 001 : pour instancier un numero en imposant un nombre minimum de chiffres ; 

• a : pour instancier un numero sous forme de sequence de lettres (a b c ... z aa ab ac ... 
az ... ba ...) ; 

• A : meme chose avec des lettres majuscules ; 

• i : pour instancier un numero en chiffres romains minuscules ; 

• I : pour instancier un numero en chiffres romains majuscules. 
Exemples : 

Numero hierarchique 

valeur: 2 4 2 5 

format: A I - 1 . a 
rendu : B I V-2 . e 

format: 001 a.i .1 
rendu : 002 d.ii .5 

lei, il y a beaucoup de possibilit.es et de variantes, notamment en utilisant les attributs 

grouping-separator, grouping-size, Tang, et letter-value. On pourra Se reporter 3U 

standard XSLT 1.0 pour une description de leurs effets respectifs. 
Exemple 

Nous allons reprendre le programmeXSLT precedent, et I'adapter pour sortir une nume- 
rotation classique des sections : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 



<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl :text> 
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<xsl :for-each select="//regle"> 

<xsl :sort select="@importance"/> 
<xsl:number val ue="position( )" format='I'/> 
<xsl:text> </xsl:text> 
<xsl :value-of select=" . "/Xxsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl :templ ate match="sectl | sect2 |sect3"> 
<xsl:number count="sectl | sect2 |sect3" 

level="multiple" format="I-l.a "/> 
<xsl :value-of select="name()"/> 
<xsl :apply-templates/> 

</xsl :templ ate> 

<xsl : tempi ate match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :template> 

<xsl :templ ate match="note" mode="inpara"> 

<xsl : number count="note" level ="any" format="l . "/> 

<xsl :text>texteNote=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match="programlisting"> 

<xsl :text>textePrograml isting=</xsl :text> 
<xsl :value-of select=" . "/> 
<xsl:text> </xsl:text> 

</xsl :templ ate> 

<xsl :templ ate match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :value-of select=" . "/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="regle" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :template> 

<xsl :template match="regle"> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) " mode="inpara"> 
<xsl :if test="normal ize-space( . )"> 
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<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

I sectl 
texteTitre=A 
texteRegle=RlRlR 
1-1 sect2 

texteTitre=B 
textePara=bbb 

I- 2 sect2 
texteTitre=C 
1-2. a sect3 

texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 

1. texteNote=Nt textePara=ddd/ 

2. texteNote=Nv 

1-2. b sect3 

texteTitre=E 
textePara=eee 

3. texteNote=Nah textePara=eee; 

textePara=e,e,e 
texteRegle=R3R3R 
textePrograml i sting=ay 
textePara=e;e;e 
textePrograml i sting=bg 
textePara=e!e!e 

texteRegle=R4R4R 

4. texteNote=Naa textePara=(eee) 

5. texteNote=Nzz textePara=[eee] 

6. texteNote=NEE textePara=(e,e,e) 

1-2. c sect3 

texteTitre=F 
textePrograml i sting=ck 

II sectl 
texteTitre=G 

I I - 1 sect2 
texteTitre=H 
textePara=hhh 
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textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Regies importantes : 

I R1R1R 

II R3R3R 

III R4R4R 

IV R2R2R 

II faut noter que le format etant fourni en tant qu'attribut, les regies general es lexicogra- 
phiques pour un attribut XML s'appliquent : certains caracteres comme ■<■ ou "&" sont 
interdits, et les espaces blancs sont normalises. Ici, en admettant que I'on veuille une 
tabulation apres les chiffres romains de la numerotation des regies, i I ne servirait a rien de 
placer cette tabulation en tant que signedeponctuation dans I e format, car el le serait nor- 
mal isee en espace ordinaire. Cela implique done de placer cette tabulation a I'exterieur, 
dans une instruction xsi :text. 



7 

Decoupage d'une application 

XSLT 



Ce chapitre decrit les outils disponibles en XSLT pour decouper une application en 
plusieurs morceaux, soit pour des raisons de maintenabilite, soit pour des raisons de 
reuti I i sabi I ite. A noterquelegrain desemantiqueXSLT estla regleou lemodelenomme ; 
la reuti I isation consiste done a constituer des bibliotheques de regies ou de model es nom- 
mes, ce qui n'est pas tres different, dans le principe, de la constitution de bibliotheques 
de sous-programmes dans des langages commeC, Pascal, Cobol, Fortran, etc. 

M ais ca, e'est du genie logiciel qui fleure bon les annees soixante (du xx e siecle), et on 
sait que le resultat n'a pas ete a la hauteur des esperances, et que la notion de biblio- 
theque de fonctions reuti I i sables ne marche que dans des cas tres precis, notamment ceux 
ou les structures de donnees manipulees par ces fonctions sont regulieres et triviales (par 
exemple, une bibliothequede fonctions mathematiquesou graphiques, qui n'utilisentque 
des tableaux). 

Des que les structures manipulees sont complexes et diversifies, la notion de biblio- 
theque de fonctions atteint ses limites, et e'est la que la notion d'objets et de classes 
prend le relais, en permettant de constituer des bibliotheques de classes, qui sont des 
grains semantiques beaucoup plus gros que des fonctions, capables d'encapsuler ces 
fameuses structures de donnees. 

Est-ce a dire que les bibliotheques de regies et de model es nommes reuti I i sables sont 
voues a I'echec, tout comme les bibliotheques de fonctions ? 

Non, car on observera que justement, en XSLT, il n'y a aucune diversity possible en 
matiere de structure de donnees. On peut meme dire qu'a part le TST attache a une va- 
riable, il n'y a rien. XSLT est fait pour manipuler desarbresXM L, pas pour model iser le 
processus metier d'une fabrique de joints de caoutchouc. 



■ Decoupage d'une application XSLT 

B I II Mill 

Neanmoins XSLT est jeune, tresjeune. On n'a pas encore le recul necessaire pour juger 
du degre effectif de reuti I isabi I ite que I'on peut atteindre avec des bibliotheques de 
regies : done, en attendant que les experiences s'accumulent et qu'une synthese puisse 
etrefaite, on peut parti r avec I 'idee qu'il y a de bonnes chances que eel a fonctionne. 

Ce chapitre presente les differentes possibility dans ce domaine. 

Instruction xshinclude 

Syntaxe 

xsi :include 

<xsl :include 
href=" ..." 

/> 

L'attri but href nedoit pasetre un descripteur de valeur differee. 
instruction xsi : include doit apparaitre comme i nstructi on de premier niveau. 

Semantique 

L'instruction xsi : include permet d'incorporer au fichier source XSLT courant les ins- 
tructionsXSLT d'un autre fichier sourceXSLT dontl'URI estfourni par I'attribut href. 

Attention 

Pour beaucoup, ce genre destruction rappelle evidemment assez fortement la directive ^include que I'on 
trouve en C ou en C++. C'estvrai qu'il y a beaucoup de ressemblance entre xsi : include et#include, puisque 
les deux servent a realiser 1'immersion d'un fichier dans le fichier courant, mais il y a une difference essentielle : 
en C ou C++, la directive #inciude est prise en charge par un preprocesseur : or il n'y a pas de preprocesseur 
en XSLT. La consequence, c'estqu'il estpossible d'avoiren C ou C++ des inclusions conditionnelles, en combi- 
nant directives include et#ifdef, parexemple, alors que e'est absolument impossible en XSLT, au moins 
directement. Remarquez bien que I'attribut href est un attribut ordinaire : ecrire un descripteur de valeur differee 
au lieu d'une valeur litterale serait une faute de syntaxe. Inutile done de tenter de fournir une valeur calculee au 
prealable dans une variable. Neanmoins, en cas de necessity on peuttoujours simulerle fonctionnementd'un 
preprocesseur : on se reportera a la section Pattern n ' 15 -G eneration d line feuille de style par une autre feuille 
de style, page 507, pourun exemple mettanten ceuvre cette idee. 

L'URI foumi comme valeur de I'attribut href peutetreun nom absolu de fichier ou une 
URL, maisil peut etre aussi un nom relatif. Dans ce cas, le fichier estcherche dansle 
repertoire courant, defini comme etant eel ui qui contient la feuille de style courante(celle 
qui comporte l'instruction xsi:inciu de). Voir la notion d'URI de base, URI de base 
(remarque en marge de ce texte), page 640. 
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Processus mis en ceuvre 

Si I'on voulait incorporer soi-meme le contenu de la feuille de style referencee dans la 
feuille de style courante, voici cequ'il faudraitfaire pour real iser I e meme travail quele 
processeurXSLT : 

• examiner les domaines nominaux declares dans instruction xsi :styiesheet de la 
feuille referencee, et les reporter dans instruction xsi :styiesheet de la feuille cou- 
rante ; 

• prelever les instructions xsi : import de la feuille referencee, et les reporter dans la 
feuille courante, en les placant apres toutes les autres instructions xsi nmport qui s'y 
trouvent deja, mais avanttoute autre instruction de premier niveau ; 

• prelever les autres instructions de la feuille referencee, et les reporter dans la feuille 
courante, a la place de instruction xsi : include concernee (voir figure 7-1, a la sec- 
tion P rocessus mis en ceuvre, page 381). 

Dans ce processus, on peut etre amene a incorporer des instructions xsi rinciude ou 
xsi : import, qui toutes lesdeux, font reference a des fichiers, identifies par des URI four- 
nis comme valeurs de I ' attri but href, commun a ces deux instructions. Si ces URI sont 
des chemins relatifs, il peut alors etre necessaire de les modifier en les incorporant, de 
telle sorte qu'ils continuent de referencer les memes fichiers (relativement au repertoire 
de la feuille principale), meme si le repertoire contenant ces fichiers n'est pas le meme 
que celui contenant la feuille principale. 

Si I'on a incorpore des instructions xsi : include, il faut bien sfir reiterer entierement ce 
processus. 

L' instruction xsi : import sera vueun peu plus loin (voir Instruction xsi: import, page 381) ; 
la seule chose qui compte ici, c'est de savoir que cette instruction doit etre placee avant 
toute autre sorted' instruction de premier niveau ; c'est ce qui expliquequ'il faille prelever 
a part les xsi : import, et les placer au bon endroit pour ne pas contrevenir a cette regie. 

Remarque 

Toutceci montre que le travail realise lors d'un xsi : include est bien plus complique qu'une simple inclusion, 
comme celle que Ton pourrait realiser par un appel d'entite externe, etqui se traduirait par une inclusion brutale 
eten I'etatdu fichier reference. 

Erreurs possibles 

Une reference circulaire (une feuille qui s'inclut elle-meme, directement ou indirecte- 
ment), est interdite, comme a I'habitude. 

Par contre, inclure deux fois la meme feuille n'est pas uneerreur en soi, mais peut even- 
tuellement induire des erreurs (par exemple, si la feuille incluse deux fois contient une 
regie xsi :tempiate, celle-ci sera done placee deux fois dans la feuille principale, entrai- 
nant done uneambiguite, puisquerien neles departage ; mais il estvrai que certains pro- 
cesseurs peuvent prendre I e parti, dans ce cas, de se recuperer en choisissant la derniere). 
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De toutefacon, inclure deux fois la meme feuille n'est pas pertinent ; c'est toujours une 
faute d'inattention ou de conception, et cela ne devrait jamais etre un but consciemment 
recherche. 

General ement, definir deux fois la meme chose dans une feuille de style est une erreur, 
done un xsi include qui amene dans la feuille principale quelque chose qui s'y trouve 
deja est un xsi n'nciude errone. M ais il convient de s'interroger ici sur le sens exact de 
cette phrase. Que veut dire en effet « qui s'y trouve deja»? Si la chose est une 
declaration de variable ou de modele nomme, il n'y a pas dedoute possible, c'est lenom 
fourni en attributqui ditsi on a un doublon ou non. 

Mais pour une regie de transformation, c'est beaucoup plus subtil, etleprocesseurXSLT 
ne peut pas toujours conclure au simple examen statique de la feuille de style, et doit se 
contenter de signaler le conflit, s'il survient a I'execution. Prenons par exemple I 'element 
B de la figure 7-1, a la section Processus mis en «uvre, page 381 ; si cet element repre- 
sente une regie de transformation avec exactement le meme motif et le meme mode dans 
la feuille principale et dans la feuille incluse, c'est sflr qu'il y a doublon. 

Leprobleme, c'est que meme si on eli mine le doublon B, on n'est pas pour autant a I 'abri 
d'un conflit. Toujours sur la meme figure (7-1), on peut voir des elements A et D dans la 
feuille resultante apres inclusion. Supposons que ces deux elements soient des regies de 
transformation avec des motifs differents ; meme differents, les deux motifs peuvent tres 
bien concorder simultaneities avec un certain noeud. Si ce noeud ne fait jamais I'objet 
d'une recherche de concordance de motif, on passe au traversdesmaillesdu filet. M ais si 
ce noeud esttraite par le processeur, alors immanquabl ement, celui-ci decouvrira les deux 
regies possibles, et I'ambiguite entre A et D sera alors prouvee. 

Enfin, il faut signaler le cas oil B serait une instruction xsi :attribute-set : cette fois, 
meme si I'attribut name est identi que dans les deux cas, il n'y a pas de conflit (sauf en cas 
d'attributs de meme nom maisdevaleursdifferenf.es), car les deux attribute-sets sont 
fusionnes. 

On voit done qu'il n'y a pas de regie simple et generale pour determiner si un xsi : 
include est correct ou non, si ce n'est de faire comme si on ecrivait une seule feuille de 
style reunissant la feuille principale et la feuille a inclure, et de veiller en particulier 
(comme d'habitude) a ne pas ecrire des regies dont les motifs ne serai ent pas assez discri- 
minants pour etre mutuellement exclusifs sur certains nceuds. 

Position des instructions xskinclude 

L eS i nstrUCtionS xsi : i ncl u de peuvent etre placees n'importe oil dans la feuille de style, 
(pourvu qu'elles apparaissent comme instructions de premier niveau), mais il semble 
preferable, en general, de les placer en tete du fichier principal. En effet, si par malheur 
I'inclusion d'une feuille amene une regie ou une definition de variable qui existe deja 
dans la feuille principale, soit on obtient un message d'erreur suite a I'apparition d'un 
ambiguite (et dans ce cas on corrige I 'erreur), soit le processeur accepte I'ambiguite et la 
resout en activant la derniere regie dans I'ordre de lecture du document. Dans ce dernier 
cas, il vaut mieux que la derniere regie soit celle de la feuille principale, cequi implique 
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que I 'instruction xsi : include fautivenesoitpas placeeversla fin de la feuille principals 
mais au contraire au debut. 

Interetde 1'instruction xshinclude 

L'interet de cette instruction, c'est de pouvoir recuperer (pour les reutiliser) des modeles 
nommes conserves dans des fichiers X SLT, et classes dans des bibliotheques, ou de pou- 
voir fragmenter un programme X SLT monolithique en plusieurs morceaux pour en faci- 
liter la lecture et la maintenance. 

Dans ces deux cas, le programme X SLT complet est constitue en incluant dans la feuille 
principale les modules desires, et ensuite, tout se passe comme si les instructions qu'ils 
conti ennent avai ent ete ec rites di rectement dans I a f eui 1 1 e pri nci pal e. 



Nous prendrons comme exemple I 'utilisation d'une bibliotheque, par exemple la « XSLT 
Standard Library », qui est une bibliotheque « Open Source », maintenue par Steve Balls 
(voir http://xsltsl.sourceforge.net). On y trouve des collections de modeles nommes dans 
differents domaines : Strings, Dates, Nodes, etc. 

Pour i 1 1 ustrer I'utilisation d'une telle bibliotheque, nous allons reprendre I'exemple 
d'annonces de concerts, vu a la section Exemple, page 223. II s'agit de produire un plan- 
ning des concerts, comme ceci : 



N ous partons d'un fichier X M L qui conti ent les annonces : 
annonces.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Annonces> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Annonce> 
<Date> 

<Jour id="mar"/> 
<Quantieme>20</Quantieme> 
<Mois id="nov"/> 
<Annee>200K/Annee> 
<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble> "Le Poeme Harmonique" </Ensemble> 

</Annonce> 

<Annonce> 



Exemple 



Planning 



Semaine 47 
Semaine 3 
Semaine 8 



"Le Poeme Harmonique" 
"A deux violes esgales" 
"Ensemble Baroque de Nice" 
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<Date> 



<Jour id="jeu"/> 
<Quantieme>17</Quantieme> 
<Mois id="jnv"/> 
<Annee>2002</Annee> 
<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble> "A deux violes esgales" </Ensemble> 
</Annonce> 
<Annonce> 
<Date> 

<Jour id="dim"/> 

<Quantieme>24</Quantieme> 

<Mois id="mar"/> 

<Annee>2002</Annee> 

<Heure>17H</Heure> 
</Date> 

<Lieu>Chapelle des llrsules</Lieu> 
<Ensemble> "Ensemble Baroque de Nice" </Ensemble> 
</Annonce> 

<!-- etc. --> 

</Annonces> 

Le programme doit done calculer le No de semaine, connaissant le quantieme, le No de 
mois, et I 'ann.ee. Predsement, e'est I'une des fonctions disponibles dans la xsltsl (XSLT 
Standard Library) ; il suffit done d'inclure le bon module et d'appeler le bon modele 
nomme : 

planning.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transforiri" 

xml ns :dt="http: //xsltsl .org/date-time" 

version="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 
<xsl : incl ude href=" . ./ . ./xsltsl -1 .O/date-time.xsl "/> 
<xsl :variable name="Dictionnai re" 



select=" document ( 'dictionnai re. xml ' )/Dictionnai re"/> 



<xsl : tempi ate match="Annonce"> 



<xsl :vari abl e 

name="quantieme" 
select="./Date/Quantieme" /> 
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<xsl :variable 
name="NoMoi s" 

sel ect="$Dictionnai re/mot [@id=cur rent ( )/Date/Mois/@id]/@num" /> 



<xsl :variable 
name="annee" 

select="./Date/Annee" /> 



<xsl :variable name="NoSemaine"> 

<xsl :cal 1 -tempi ate name="dt :cal cul ate-week-number"> 
<xsl :with-param name="year" sel ect="$annee"/> 
<xsl :with-param name="month" select="$NoMois"/> 
<xsl :with-param name="day" select="$quantieme"/> 
</xsl :call-template> 
</xsl :variable> 



<xsl :text> 

Semaine </xsl :text> 

<xsl :val ue-of select="$NoSemaine"/> : <xsl :value-of select="./Ensemble"/> 



</xsl :templ ate> 



<xsl : tempi ate match="text( )" /> 



</xsl :stylesheet> 

Pour obtenir le bon numero de mois, on se base comme dans I'exemple (voir Exemple, 
page 223) de la traduction par dictionnaire (bien qu'il n'y ait pas de traduction a faire 
cette fois-ci), legerement modifie pour faire figurer les numeros de mois (seuls les mois 
utiles sont montres, pour gagner de la place) : 

Dictionnaire.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Dictionnaire> 



<mot id="jnv" num="l"> 

<traduction 1 ang="f r">janvier</traduction> 
<traduction 1 ang="en">january</traduction> 

</mot> 



<mot id="mrs" num="3"> 

<traduction 1 ang="f r">mars</traduction> 
<traduction 1 ang="en">march</traduction> 

</mot> 



<mot id="nov" num="ll"> 

<traduction 1 ang="f r">novembre</traduction> 
<traduction 1 ang="en">november</traduction> 

</mot> 



</Dictionnaire> 
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Le resultat obtenu est eel ui montre plus haut. 

On observera le domaine nominal impose par xsltsl ("http://xsitsi .org/date-time"), 
associe au prefixe "dt:" qui qualifie le nom du modele a appeler (dt:caicuiate-week- 

number). 

On remarquera aussi au passage I'emploi de la fonction currento, exactement pour la 
meme raison que eel le qui a ete vue tout a la fin de la section Exemple, page 187. 

A titre de curiosite, voici le code XSLT correspondantau modele nomme dt:caicuiate- 

week-number : 

date-time.xsl (extrait) 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<xsl :stylesheet 
version="1.0" 

extension -el ement-pref ixes="doc" 
xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
xml ns :doc="http: //xsl tsl .org/xsl /documentation/1 .0" 
xml ns :dt="http://xsl tsl .org/date-time" 

> 

<xsl :template name="dt:calculate-julian-day"> 
<xsl:param name="year"/> 
<xsl:param name="month"/> 
<xsl:param name="day"/> 

<xsl rvariable name="a" select="floor((14 - Smonth) div 12)" I > 
<xsl variable name="y" sel ect="$year + 4800 - $a"/> 
<xsl variable name="m" sel ect="$month + 12 * $a - 3"/> 

<xsl :value-of select="$day + floor((153 * $m + 2) div 5) + 

$y * 365 + floor($y div 4) - floor($y div 100) + 
floor($y div 400) - 32045"/> 

</xsl :templ ate> 

<xsl :template name="dt:calculate-week-number"> 
<xsl:param name="year"/> 
<xsl:param name="month"/> 
<xsl:param name="day"/> 

<xsl :variable name="J"> 

<xsl :call -tempi ate name="dt :cal cul ate-jul ian-day"> 

<xsl :with-param name="year" sel ect="$year"/> 

<xsl :with-param name="month" sel ect="$month"/> 

<xsl :with-param name="day" sel ect="$day"/> 

</xsl :call-template> 
</xsl :variable> 

<xsl :variable name="d4" select="($J + 31741 - ($J mod 7)) mod 146097 

mod 36524 mod 1461"/> 
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<xsl :variable name="L" select="floor($d4 div 1460) "/> 

<xsl :variable name="dl" select="(($d4 - $L) mod 365) + $L"/> 

<xsl :val ue-of select="floor($dl div 7) + l"/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Quand on voit ce a quoi on a echappe, on se dit que finalement, ce n'est pas plus mal 
qu'il existe une XSLT Standard Library , et une instruction xsi include pour s'en ser- 
vir ! 

Instruction xshimport 

Syntaxe 

xsi : import 

<xsl : import 
href=" ..." 

/> 

L'attri but href nedoit pasetre un descripteur de valeur differee. 

L'instruction xsi : import doit apparattre comme instruction de premier niveau, etdeplus 
doit apparattre avant toute autre instruction. 

Semantique 

L'instruction xsi import permet d'incorporer au fichier source XSLT courant les ins- 
tructions XSLT d'un autre fichier source XSLT dont I'URI est fourni par l'attri but href. 
La difference avec xsi : include tient a ceque les conflits, en cas de definitions multiples 
d'une meme instruction XSLT, ne sont pas necessai rement des cas d'erreurs, et peuvent 
etre resolus grace a des regies specifiques. 

L'interpretation de la valeur de I ' attri but href se fait comme pour ^instruction xsi : 
include (voi r Semantique, page 374). 

Processus mis en ceuvre 

Le processus d'incorporation des instructions XSLT provenant d'une feuille de style 
importeeest le meme que eel ui d'une inclusion (voir Processus mis en ceuvre, page 375). 
Ce qui change, e'est I 'interpretation du resultat une fois ^incorporation terminee. On 
peut exprimer cela assez facilement sur un dessin (voir figure 7-1, oil A, B, C, et D repre- 
sented des instructions XSLT quelconques) : dans le cas d'une inclusion, la double 
presence de l'instruction B pose (en general) probleme, mais pas dans le cas d'une 
importation. 
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Figure 7-1 

Comparaison 
inclusion- 
importation. 



Feuille XSLT 



Feuille XSLT 



Feuille XSLT 




Feuille XSLT 




Note 

La figure 7-1 suggere un conflit potentiel entre I'element B de la feuille principale et I'element B de la feuille 
importee. Neanmoins, il fautgardera I'espritqu'une stricte identite d'elementn'estpas necessaire a I'apparition 
d'un conflit: deux regies de transformation de motifs differents peuvent (res bien engendrer un conflit sur un 
certain nceud, si les deux motifs concordent simultanement avec ce nceud. La figure est ici un support visuel qui 
permetde mettre en evidence les endroits ou Ton discute d'un conflit, mais elle ne doit pas faire croire que les 
conflits ne peuvent pas surgir ailleurs. 



Dans le cas d'une importation, le conflit entre les deux instructions B, s'il existe, est 
resolu par la prise en compte d'un indicateur de preseance. Cet indicateur est un entier 
d'autant plus negatif que la preseance est faible : dans le cas de la figure 7-1, le B vain- 
queur estcelui qui provientde la feuille courante, (preseanceO), alors que I 'autre B , pro- 
venant de la feuille importee, a la preseance -1 (les valeurs absolues de ces indicateurs 
sont arbitraires : cequi compte, ce sont I eurs valeurs relatives). 

Le cas simple, pour le calcul de cet indicateur, est celui ou chaque feuille ne contient 
qu'une seule instruction xskimport ; dans ce cas la valeur absolue de I'indicateur est le 
nombred'importationsqui separe I 'element importede la feuille courante (voir figure 7-1). 

Dans I'exemple de la figure 7-2, I'element E a la preseance (-2) parce qu'il y a deux 
importations a effectuer pour I'incorporer a la feuille courante. 

Le cas general est celui ou il peut y avoir plusieurs instructions xsi rimport dans cer- 
taines des feuilles X SLT (voir figure 7-3). 
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Figure 7-2 

Importations en 
cascade, calcul 
de la preseance. 



Feuille XSLT 



Feuille XSLT 



Feuille XSLT 
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Feuille resultante 



d -B(-3) 
|- D (-3) 

>B (-2) 
[_E (-2) 

°|- D (-D 

^mot 

a • B (0) 
•C (0) 



Done le dernier sous-arbre d'importations issu du dernier xsi : import, dans I'ordre de 
lecture de la feuille courante, a preseance sur I'avant dernier, qui lui-meme, a preseance 
sur celui qui le precede, etc. 

Dans notreexemple, celaveut dire quel es indicateurs de preseance, pour I es elements du 
sous-arbre issu de la feuille (c), sont tous superieurs aux indicateurs affectes aux ele- 
ments du sous-arbre issu de la feuille (b). 

II faut done faire le calcul en partant du dernier xsi : import, et en calculant des indica- 
teurs de preseance toujours de plus en plus faibles : on applique la regie du pipe pour 
choisir une branche, etcelledu nombre d'importations quand on suit une branche. 

A noter que les instructions xsi : i ncl u de ont bien sur un effet nul dans ce calcul ; e'est 
pourquoi les elements B desfeuilles (f) et (b) ont meme indicateur de preseance. 

Une fois qu'on a les indicateurs de preseance, on s'en sert uniquement s'il y a con/Zit, 
pour choisir I 'element a prendre en compte. Si deux elements de meme preseance sont en 
conflit, e'est un cas d'erreur, le processeur XSLT pouvant eventuellement choisir de 
prendre le dernier element dans I'ordre de lecture de la feuille resultante. 

Comme d'habitude, lorsque la detection d'un conflit repose sur une comparaison de 
noms prefixes, il ne faut pas se laisser abuser par des prefixes eventuellement differents : 
cequi compte, ce sont les domaines nominaux, pas les prefixes. 
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Figure 7-3 

Arbre d 'importations, 
calcul de la preVance. 



Feuille XSLT 
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• B 


f 







• B 


d 





Feuille resultante 

g|»B (-5) 
f [• B (-4) 

D |« D (-4) 
e|'E (-3) 
d|« B (-2) 

^bttt 

c |» D (-1) 

•A (0) 
a«B (0) 
•C (0) 



Regie du pipe 

Premier importe, premier ecarte : autrement dit, dans une feuille XSLT, la derniere importation, dans I'ordre de 
lecture du document, a la preseance la plus grande. 
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Interetde (Instruction xshimport 

L'instruction xsi : import a un air de famille avec I 'heritage dans les langages a objets : 
une classe A peut heriter d'une classe B, et dans ce cas A « recupere » les methodes et 
attributs declares dans B. S'il n'y a aucun recoupemententre les classes A et B, I 'heritage 
revient a une simple addition des methodes et attributs de B dans A. M ais A peut aussi 
redefini r certai nes methodes de B , ce qui revi ent a di re que A n'accepte pas tout I 'heritage 
deB tel quel. 

II en va de memeavec xsi : import : si A importeB, il herite des elements definis dans B, 
maisil peut aussi en redefini r certains. 

En resume, xsi include, c'est de I'heritage sans redefinition, alorsquexsi import, c'est 
de I 'heritage avec redefinition possible : on utilise xsi : i ncl u de quand on est satisfait de 
cequ'on recupere, etxsi : import quand on aimeraitbien personnaliser certains elements. 

Exemple 

L'exemple que nous al Ions voir va montrer comment personnaliser un element de 
DocBook. 

Note 

Docbookestune DTD associee ades feuilles de style XSLT pour rediger des articles, des livres, et plus genera- 
lementde la documentation. Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook.org). 

A titre de curiosite, voici un extraitde document redige en DocBook : 

<?xml version="1.0" encoding="UTF-16" ?> 
<!DOCTYPE article SYSTEM "customdocbook.dtd"> 
<article lang="fr"> 
<articleinfo> 
<author> 

<f i rstname>Phi 1 i ppe</f i rstname> 

<surname>Drix</surname> 

<affiliation> 

<jobtitle>Consultant Architectures Objet</jobtitl e> 
<orgname>Objecti va</orgname> 
</affil iation> 
</author> 

<title>SPECIFICATION XML DU REFERENTIEL METIER DE L' APPLICATION 

CANOFETE</title> 
<revhistory> 

<revision> 

<revnumber>l .0</revnumber> 
<date>7-XI-200K/date> 
<authorini tial s>PhD</authorinitial s> 
<revremark>Creation du document. </revremark> 
</revision> 
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</revhi story> 
</articleinfo> 
<abstract> 

<para>Ce document presente les composants XML de 1 'appl ication 
Canofete, cote referentiel metier, et non cote presentation. 
Ces composants XML sont tous lies au generateur de code Java, 
et decrivent les transactions et les services fonctionnels.</para> 

</abstract> 

<sectl> 

<title>Introduction - Structure generale</title> 
<sect2> 

<title>Fichier <emphasis>CyclaModel .xml</emphasi sX/titl e> 
<para> 

Le generateur part du fichier 

XML <f i 1 ename>Cycl aModel .xml</filename>, qui 

decrit la correspondance entre les objets metiers et les 

differentes tables de la base de donnees LASSO. 

</para> 

<!-- etc. --> 

</arti cl e> 

DocBook est disponible gratuitement sur le site precite, et apres installation, on obtient 
(entre autres) des feuilles de style pour un rendu HTML ou FO. 

On peutbien sur uti I iser DocBook tel quel ; maisvoici le debut del a feui lie de style prin- 
cipal : 

docbook.xsl 

<?xml version='1.0'?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xmlns:doc="http://nwal sh.com/xsl /documentation/ 1.0" 

excl ude-resul t-pref ixes="doc" 

version='1.0'> 

<xsl:output method="html " 

encoding="IS0-8859-l" 
indent="no"/> 

< i __ ******************************************************************** 

$Id: docbook.xsl ,v 1.6 2001/07/04 16:17:43 uid48421 Exp $ 
******************************************************************** 

This file is part of the XSL DocBook Stylesheet distribution. 
See ../README or http://nwalsh.com/docbook/xsl/ for copyright 
and other information. 

******************************************************************** 



<! 



> 
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<xsl 


incl ude 


href= 


". . /VERSI0N"/> 


<xsl 


incl ude 


href= 


"param.xsl "/> 


<xsl 


incl ude 


href= 


" . ./I ib/1 ib.xsl "/> 


<xsl 


incl ude 


href= 


" . . /common/1 lOn .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/common. xsl "/> 


<xsl 


incl ude 


href= 


" . . /common /l abel s .xsl "/> 


<xsl 


incl ude 


href= 


" . . /common /ti ties .xsl "/> 


<xsl 


incl ude 


href= 


" . . /common /subti tl es .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/gentext.xsl "/> 


<xsl 


incl ude 


href= 


"autotoc.xsl "/> 


<xsl 


incl ude 


href= 


"1 ists .xsl "/> 


<xsl 


incl ude 


href= 


"cal 1 out. xsl "/> 


<xsl 


incl ude 


href= 


"verbatim. xsl "/> 


<xsl 


incl ude 


href= 


"graphics. xsl "/> 


<xsl 


incl ude 


href= 


"xref .xsl "/> 


<xsl 


incl ude 


href= 


"formal .xsl "/> 


<xsl 


incl ude 


href= 


"table. xsl "/> 


<xsl 


incl ude 


href= 


"sections. xsl "/> 


<xsl 


incl ude 


href= 


"inline. xsl "/> 


<! — 


etc. --> 





L a feui I lede style commence done par un grand nombred' inclusions, etnotammentcelle 
du fichier Inline. xsl. 

Cefichier inline, xsi conti ent (entre autres) I es regies suivantes : 
inl ine.xsl 

<xsl :template name="inline.monoseq"> 
<xsl:param name="content"> 

<xsl :cal 1 -tempi ate name="anchor"/> 

<xsl :apply-templates/> 
</xsl :param> 

<tt><xsl :copy-of select="$content"/X/tt> 
</xsl : tempi ate> 

<xsl :template match="f i 1 ename"> 

<xsl :call-template name="inline.monoseq"/> 
</xsl : tempi ate> 

On voit que lecontenu de la balise <-mename> est rendu en XHTM L sous la forme <tt> 
. . .</«>. Supposons quecela ne nous plaise pas completement : on voudrait qu'un nom 
declasseCSS soit precise, afin qu'il puisseetre possible de regler finementlerendu d'un 
nom de fichier, commececi : 

<tt class="filename">CyclaModel .xml</tt> 

Avec une importation, e'est tres simple a faire : on constitue une feui lie principale dans 
laquelle on importe docbook.xsi, puison redefinitcequi neva pas. 
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monDocBook.xsl 

<?xml version='1.0'?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version='1.0' 

xml ns="http: //www. w3.org/TR/xhtml 1/transi tional " 
excl ude-resul t-pref ixes="#defaul t"> 

<xsl : import 

href="f i le: 1 1 lc: \DocBook\docbook-xsl -1 .45\html \docbook.xsl "/> 

<xsl :templ ate name="inl ine.monoseq"> 
<xsl :param name="cssCl assName"/> 
<xsl:param name="content"> 

<xsl :call-template name="anchor"/> 

<xsl :apply-templates/> 
</xsl :param> 

<tt class="{$cssClassName}"Xxsl :copy-of sel ect="$content"/X/tt> 
</xsl :template> 

<xsl :templ ate match="f i 1 ename"> 

<xsl :call-template name="inl ine.monoseq"> 

<xsl :with-param name="cssCl assName" select=" 'filename "7> 

</xsl :call-template> 
</xsl :template> 

</xsl :stylesheet> 

Le resultat est conforme aux arterites. 

Instruction xshapply-imports 

Syntaxe 

xsl : apply- imports 

<xsl :apply-imports/> 

instruction xsi :appiy-imports ne doit pas apparaftre comme instruction de premier 
niveau. 

Regie XSLT typique 

Une regie XSLT utilisant instruction xsi :appiy-imports sera souvent employee 
comme ceci : 

<xsl :templ ate match="... motif (pattern) ..."> 
<xsl :apply-imports/> 



</xsl :templ ate> 
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Semantique 

L'i instruction xsi :appiy-imports est une instruction qui ne sert que lorsqu'on redefinit 
une regie de transformation importee (heritee) d'une autre feuille de style. II y a alors 
deux cas possibles : 

• Le nouveau modele de transformation n'a pas grand-chose a voir avec I'ancien (celui 
qu'on redefinit) ; dansce cas, I'instruction xsi :appiy-imports n'estd'aucun secours, 
inutile de I'utiliser. 

• Le nouveau modele de transformation se contente d'ajouter quelque chose de plus a 
I'ancien ; dans cecas, pourquoi recopier I'ancien ? II vaut beaucoup mieux avoir une 
instruction qui permette de demander I 'application del'ancienne regie : c'est le butde 

xsl :apply-imports. 

Done, lors de I'instanciation de I'instruction xsi :appiy-imports, le processeur XSLT 
relance une recherche des regies dont le motif concorde avec le nceud courant, mais 
limite sa recherche aux regies dont la preseance est plus faible que eel le de la regie en 
cours (Processus mis en ceuvre, page 381) ; ces regies sont done necessairement des 
regies importees, et au cas ou plusieurs conviendraient, eel le qui a la preseance la plus 
forte est choi si e. 

Si I'on reprend I'exemple de la figure 7-3, de la section Processus mis en auvre, 
page 381, et que I'on suppose que I'element B, dans la feuille (a), est une regie dont le 
modele de transformation contient I'instruction <xsi :appiy-imports/>, alors I'instan- 
ciation de cette instruction <xsi :appiy-imports/> se traduira par I'application de la 
regie B dela feuille (c), puisque c'est eel le dont le motif va a nouveau concorder avec le 
nceud courant, et dont la preseance est la plus forte parmi les feuilles de preseance plus 
faible que eel le dela regie en cours. 

Le modele de transformation de la regie trouvee est alors instancie, et cette instanciation 
est eel lede I'instruction <xsi :appiy-imports/>. 

Remarque 

L'instanciation d'une instruction <xsi :appiy-imports/> necessite de connaitre deuxchoses : la regie courante, 
et le nceud courant : la regie courante, parce qu'on en cherche une autre de meme mode, (s'il y en a un), et le 
nceud courant, parce que le motif de la regie choisie doit concorder avec ce nceud courant. C'est pourquoi cela 
n'aurait pas de sens d'instancier une instruction <xsi :appiy-imports/> a I'interieurdu modele de transforma- 
tion d'une instruction <xsi :for-each>, puisque par definition, cette instruction modifie le nceud courant (et c'est 
la seule qui sache faire cela), Pour cette raison, ilestinterditde placer une instruction <xsi :appiy-imports/> a 
I'interieur d'une instruction <xsi :for-each>. 



Enfin, si I'on reprend I'analogie entre xsl : import et I 'heritage des langages a objets, on 
voit immediatement que <xsi :appiy-imports/> reprend I 'idee d'un objet qui, lors de 
I'execution d'une methode heritee et redefinie, lance I'execution de la version originale 
de la methode courante (mot cle super en J ava et en Smal Italk), telle qu'on la trouve dans 
la classe heritee. 
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Attention 

Neanmoins, il ne faut pas pousser I'analogie trap loin, car dans le cas d'un langage a objets, la methode liee a 
super estconnue a priori, alors que dans le cas de XSLT, on recommence une nouvelle recherche de regie par 
concordance de motif parmi les regies de preseance inferieure, de sortequ'on peuttres bien selectionnerfinale- 
mentune regie dontle motif n'a pas du toutle meme aspectque celui de la regie courante. 
Dans le cas de la figure 7-3, parexemple (voir Processus mis en ceuvre, page 381), il pourraittres bien sefaire 
que I'elementD de la feuille (c) soit une regie de transformation contenantl'instruction <xsi : apply- imports/>, 
dontl'instanciation se traduise finalement par I'activation de la regie E de la feuille (e). 

Exemple 

Nous reprendrons a nouveau comme exemple ce qui est fait dans DocBook (voir 
Exemple, page 385). L'instruction <xsi :appiy-imports/> y est utilisee (entre autres) 
pour resoudre elegamment le probleme maintenant decrit. 

On a un certain nombre de balises pour decrire la structure d'un document, parmi les- 
quelles : <para>, <secti>, <sect2>, <chapter>, etc., dont les noms parlentd'eux-memes. 
On a done en consequence, dans docbook.xsi, des regies pour definir le rendu (HTM L 
ou FO) dechacun deces elements. Parexemple: 

<xsl :templ ate match="para"> 
<P> 

<xsl:if test="position( ) = 1 and parent :: 1 istitem"> 

<xsl :ca11-template name="anchor"> 
<xsl :with-param name="node" select="parent: :listitem"/> 

</xsl :cal 1 -tempi ate> 
</xsl :if> 

<xsl : call -tempi ate name="anchor"/> 
<xsl :apply-templates/> 
</p> 
</xsl :templ ate> 

On suppose maintenant que Ton veut ecrire une documentation technique qui mette en 
evidence les evolutions par rapport a la version precedente. Ces evolutions peuvent etre 
des modification, des ajouts, ou des suppressions. Docbook fournit de quoi faire cela. 1 1 

SUffit de rajOUter Un attri but revisionflag ( added, deleted, changed) SUr les elements 

concernes : 

<para revisionflag="added" > 

Le generateur part du fichier 

XML <f i 1 ename>Cycl aModel .xml</filename>, qui 

decrit la correspondance entre les objets metiers et les 

differentes tables de la base de donnees LASSO. 

</para> 

Pour beneficier de la prise en charge decet attri but, il suffit de lancer I 'execution non pas 

de docbook.xsi , maiS de changebars . xsl . 
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Voici lafa?on dont est realisee cette feuille de style : 

changebars.xsl 

<?xml version="1.0"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl : import href="docbook.xsl "/> 

<xsl:param name="show.revisionflag" select="'l'"/> 

<xsl :template name="user.head.content"> 



<style type="text/css"> 
<xsl :text> 

div. added { background-color: yellow; } 
div. deleted { text-decoration: line-through; 



span. added { background-color: yellow; } 
span. deleted { text-decoration: line-through; 

background-color: #FF7F7F; } 
span. changed { background-color: lime; } 



</xsl :text> 
</style> 
</xsl :templ ate> 

<xsl :template match="*[@revisionflag]"> 
<xsl :choose> 
<xsl :when 



test=" 


1 ocal 


-name( . ) 


= 'para' 


or 


1 ocal 


-name( . ) 


= 'section' 


or 


1 ocal 


-name( . ) 


= 'sectl' 


or 


1 ocal 


-name( . ) 


= 'sect2' 


or 


1 ocal 


-name( . ) 


= 'sect3' 


or 


1 ocal 


-name( . ) 


= 'sect4' 


or 


1 ocal 


-name( . ) 


= 'sect5' 


or 


1 ocal 


-name( . ) 


= 'chapter' 


or 


1 ocal 


-name( . ) 


= 'preface' 


or 


1 ocal 


-name( . ) 


= 'itemizedlist' 


or 


1 ocal 


-name( . ) 


= 'varl istentry ' 


or 


1 ocal 


-name( . ) 


= 'glossary' 


or 


1 ocal 


-name( . ) 


= 'bibliography' 


or 


1 ocal 


-name( . ) 


= 'index' 


or 


1 ocal 


-name( . ) 


= 'appendix' "> 



<div class=' {@revisionflag} '> 



div. changed 
div. off 



background-color: #FF7F7F; } 
background-color: lime; } 



span. off 
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<xsl :apply-imports/> 
</div> 

</xsl :when> 
<!-- ... --> 
</xsl :choose> 
</xsl :template> 

</xsl :stylesheet> 

Vous voyez la si mpl i cite avec laquelle cette modification somme toute non triviale a ete 
realisee : une regie (une seule), dont le motif concorde avec tout element possedant un 
attri but revisionfiag a ete ecrite. Son instanciation produit un bloc <div> equipe d'un 
attri but declasse CSS pour la miseen evidence de la modification apportee, puis le rendu 
de I 'element concerne est laisse aux regies de la feuille importee, et immerge dans I e bloc 
<div>. A noter qu'on est ici dans un cas oil le motif de la regie a selectionner dans la 
feuille importee est selon toute vraisemblancetres different du motif dela regie courante, 
puisqu'a priori, il n'est pas question de revisionfiag dans la feuille originale. 

Evolution 

Le Working Draft XSLT 1.1 a propose d'ajouter une possibility de transmettre des argu- 
ments lors de I'appel <xsi :appiy-imports>, suivant le meme schema que pour 
<xsi :appiy-tempiates>. Cette proposition a ete reprise par le Working Draft XSLT 2.0. 
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C hapitre 8. Patterns deprogrammation 395 

C hapitre 9. Patterns de transformation 443 




Remarque 

Si Ton regarde le Dictionnaire historique de la langue franpaise(Dictionnaire historique de la langue frangaise, 
sous la direction d'Alain Rey, Dictionnaires Le Robert, Paris, 1998), a I'entree Paterne, on trouve : adjectif carac- 
terisant un air de bienveillance paternelle ; derive du latin « pater, pere ». Si Ton regarde ensuite I'arbre de 
derivation du mot latin « pater », I'une des branches mene au frangais « patron ». A I'entree « Patron », on 
trouve (entre autres) : vers 1100, signifie « modele, exemple d'un livre », puis devientun terme metier designant 
le modele suivant lequel on fabrique un objet. L'anglais « pattern » est la forme alteree du moyen anglais 
« patron » (xn e siecle), emprunte a cette epoque au frangais sans changement de sens. 
La boucle estbouclee : le frangais paterne et l'anglais pattern sontdeux mots de la meme origine, etplutotque 
de traduire pattern, je prefere reprendre le mot tel quel ; il sera it possible de changer legerement la graphie, pour 
lui redonner un aspect frangais, par exemple en ajoutant un « e » final, mais cela aurait peut-etre tendance a 
derouter les lecteurs habitues a employer ce mot anglais sans trap se poser de questions. 
A noterque l'anglais pattern a deux sens assez differents pource qui touche XSLT : il y a pattern au sens de 
motif, pour les attributs match de xsi : tempi ate, xsi :key, etc., et il y a pattern au sens de design pattern. II 
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Patterns de programmation 



Les patterns de programmation sont des combinaisons d'elements de programmation en 
X SLT qui reviennent souvent dans la pratique. 

Ces patterns ne sont en general pas des butsen soi, mais plutotdesetapesdans le proces- 
sus de creation d'une certaine feuille de style. XSLT estun I angage encore tresjeune, il 
est done certain qu'on est loin d'avoir identifie tous les patterns de programmation. II est 
meme probable que certains patterns n'ont encore jamais ete imagines par personne. II ne 
fautdonc en aucunefacon considerer ce catalogue commeexhaustif. A u contraire, il faut 
s'attendre a ce qu'il s'etoffedeplusen plus. 



Pattern n° 1 - Inclusion conditionnelle de feuille de style 

Motivation 

Les inclusions conditionnel les sont des inclusions defeui lies de style differentes en fonc- 
tion d'une certaine condition evaluee a I'execution. Les motivations pour realiser de tel - 
les inclusions conditionnel les peuventetreclassees en deux categories : les bonnes et les 
mauvaises. Quoi qu'il en soit, el les se heurteront toujours a une triste realite : e'est stric- 
tement impossible a faire en XSLT, que ce soit d'une facon directe en utilisant un des- 
cripteur de valeur differee d'attri but href (chose qui n'est pas autorisee par la grammaire 
XSLT), ou par I 'une des nombreuses manieres detournees (dont on a trace dans les 
mailing-lists ou forums consacrees a XSL) qui ont ete imaginees par des utilisateurs 
s'acharnant sur ce probleme insoluble. 
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Realisation 

En reprenantnotreclassemententre bonne etmauvaise motivation, on peutdirequ'il y a 
deux manieres de s'en sortir : 

• soit prendre conscience qu'une inclusion conditi onnel le est une mauvaise reponse a un 
vrai probleme (dans ce cas voi r si une i nversi on de perspective entre f eui 1 1 es i ncl uantes 
etfeui lies incl uses ne serai t pas la bonne solution) ; 

• soit s'orienter vers une solution ou I'on doit ecrire une f eui lie de style qui produit 
comme resultat une nouvelle f eui lie de style, dont les instructions xsl : i ncl ude SOnt 
exactement adaptees au cas determine dynamiquement dans la premiere feuille. 

Dans ce dernier cas, ou une feuille de style en genere une autre, reportez-vous a la section 
Pattern n° 15 - Generation d'une feuille de style par une autre feuille de style, page 507, 
pourun exemple de realisation i 1 1 ustrant ceprincipe. 

Pour le premier cas, ou I'on doit evaluer la solution de I'inversion de perspective, I 'idee 
est la suivante : une feuille de style A (contenant des transformations standard), veut 
inclure conditionnellement une feuille de style B ou C ou D ... (contenant des variantes 
particulieres), a choisir entre plusieurs possibles, en fonction par exemple d'un profil 
d'utilisateur. L'inversion de perspective consiste a creer n f eui 1 1 es de style principal es B, 
C,D, qui toutes, incluent la feuille standard A. L'aspect conditionnel de I 'affaire est 
alors reporte a un niveau superieur, celui ou on lance I 'execution de la feuille de style : il 
s'agit de lancer la bonne, en fonction de conditions qui ne sont plus du ressort d'XSLT, 
maisdel'environnementd'execution (shell scripts, servlets, etc.). 



Pattern n° 2 - Fonction 

Motivation 

En XSLT, il y a des fonctions predefines au sens habituel du terme, mais il n'y a pas de 
construction, dans le langage, qui permette de definir une fonction renvoyant une valeur. 
Ce qui s'en rapproche le plus, c'est le model e nomme, qui peut etre appele avec des argu- 
ments, comme c'estle cas pour unefonction. M ais unefonction renvoi e une valeur, alors 
qu'un modele nomme instancie un modele de transformation. II esttoutefois possible, en 
y mettant un peu du si en cote appelant, d'ecrire un modele nomme qui fait comme si une 
valeur etait renvoyee. 

Realisation 

L'idee est de recuperer le resultat de I'instanciation dans une variable, et de renforcer la 
lisibilite du modele nomme en tant que fonction en utilisant une variable result. 



Modele nomme renvoyant une valeur 



<xsl : tempi ate name="xxx"> 
<xsl:param name="yyy"/> 
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<xsl:param name="zzz"/> 

<xsl :variable name="result"> 

... corps de la "fonction" ici ... 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl : tempi ate> 

L'instanciation du model e de transformation (i.e. le corps de la « fonction ») a lieu dans 
la variable result ; cette instanciation peutetreabsolument quelconque, et produire une 
chaine de caracteres ou un nombre, ou un node-set sous la forme d'unTST (voir Temporary 
Source Tree, page 192). 

La variable result a un effet essentiel sur la clarte de lecture du modele nomme : el le 
annonce qu'il y a un resultat (done que Ton tente de mimer une fonction), et que e'est 
el I e qui va contenir ce resultat. Cette variable n'ayant aucun effet algorithmique propre- 
ment dit, el I e pourrait tres bien etre eliminee, si Ton n'avait pas dans I' idee de I'utiliser 
uniquement pour son effet d'annonce. 

Pour que le modele nomme puisse transmettre effectivement quelque chose a I 'appelant, 
il faut done instancier en derniere instruction une copie du resultat, e'est-a-dire de la 
variable result. Ici, une instruction xsi :vaiue-of ne suffirait pas toujours, car il faut 
prevoir lecas oil la variable result contient un TST. Dans cecas, xsi :copy-of est indis- 
pensable pour real iser une copie complete de tout ce qui se trouve dans cette variable ; et 
comme xsi :copy-of est equivalente a xsi :vaiue-of pour des valeurs simples comme 
string ou Number, on peut done utiliser xsi :copy-of dans tous les cas de figure. 

Appel du modele nomme renvoyant une valeur 

<xsl :variable name="result-xxx"> 
<xsl :cal 1 -tempi ate name="xxx"> 

<xsl :with-param name="yyy" select=" . . . "/> 
<xsl :with-param name="zzz" select=" . . . "/> 
</xsl : call -tempi ate> 
</xsl :variable> 

L'appel n'est pas transparent : pour obtenir I 'effet recherche, il faut aussi adopter des 
conventions d'appel. Le resultat renvoye par le modele nomme etant une instanciation de 
modele de transformation, il faut recuperer ce resultat dans une variable lors de l'appel. 
On englobe done l'appel proprementditdansunevariablequelconque, qui va representer 
le resultat de l'appel. Dans le canevas ci-dessus, on peut dire que la variable resuit-xxx 
contient le resultat de l'appel de la « fonction » XXX. 



Exemple 



Fonction index-of 




<!-- renvoie l'indice du debut de 'testString' dans 'aString' --> 
<!-- renvoie -1 si 'aString' ne contient pas 'testString' --> 
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<xsl : tempi ate name="index-of "> 
<xsl:param name="aString"/> 
<xsl:param name="testString"/> 

<xsl :variable name="result"> 
<xsl :choose> 

<xsl :when test=" containst $aString, StestString ) "> 
<xsl :variable name="string-Before"> 
<xsl :value-of 

select="substring-before( $aString, StestString )" /> 
</xsl :variable> 

<xsl :value-of select="l+string-length( Sstring-Before )" /> 
</xsl :when> 

<xsl :otherwise> 
-1 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

Appel de la fonction index-of 

<!-- indice de la premiere apostrophe dans 'stringToSplit' --> 
<xsl variable name="indexOf-fi rstApos"> 
<xsl :call-template name="index-of "> 

<xsl :with-param name="aString" select="$stringToSplit"/> 
<xsl :with-param name="testString" select='"&apos;"'/> 
</xsl : cal 1 -tempi ate> 
</xsl :variable> 

<!-- indice du premier espace dans 'stringToSplit' --> 
<xsl variable name="indexOf-fi rstSpace"> 
<xsl : call -tempi ate name="index-of "> 

<xsl :with-param name="aString" select="$stringToSplit"/> 
<xsl :with-param name="testString" select= /> 
</xsl :call-template> 
</xsl :variable> 



Pattern n° 3 - Action 

Motivation 

lei, action s'oppose a fonction. Une fonction renvoi e unevaleur, alorsqu'une action rea- 
lise un certain traitement. Cequi est tout a fait paradoxal, c'estquelelangageXSLT est 
un langage fonctionnel (embryonnaire, certes, mais pur, en ce sens que la notion d'effet 
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de bord affectant les objets manipules est etrangere au langage) ; et pourtant la notion de 
fonction n'existe pas completement (voir ci-dessus), alors que la notion de modele 
nomme, qui el I e, existe bel et bien, correspondrait plutot a la notion d'action real isant un 
certain effet de bord. Le paradoxe disparait quand on remarque que la seule action que 
puisse real i ser un modele nomme, c'est instancier un modele de transformation. Cela 
peut se traduire effectivement par un effet de bord, mais c'est un effet de bord qui ne 
concerne pas les objets manipules : 

• soitil affecte I'etat du document resultat a construi re, qui est externeau programme (i I 
n'y a aucun moyen de recuperer dans une variable, ou de quelque autre facon, I'etat 
courant du document resultat en cours de construction) ; 

• soit leflux de sortie de I 'instanciation est capture par une variable, qui estainsi definie 
et initialised simultanement, mais en aucun cas modifiee (done cecas n'est pas un cas 
d'effetdebord). 

Conclusion 

La seule action possible, en XSLT, c'est I 'instanciation d'un modele de transformation. 

C hoi si r entre fonction et action consistedonc asedemander si I'on prefere obtenir une 
valeurou instancier un model ede transformation : si I'on veut obtenir une valeur, utiliser 
le pattern Fonction ; si I'on veut instancier un modele, utiliser le pattern Action. 



Realisation 

Etantdonne qu'un modele de transformation correspond exactementa la notion d'action, 
la realisation est triviale. La seule question est de savoir si I'on realise une action ano- 
nyme, ou si I'on opte pour une action nominee. Dans ce dernier cas, il est bon de 
donner un nom a I 'action qui rappelle explicitement que I 'action est une instanciation. 
U n modele nomme representant une action devrait toujours avoir un nom de la forme 
instancier-xxx, puisqu'il n'y a absolument aucune autre possibility d'action en XSLT. 

Modele nomine real isant une action 

<xsl :template name="instancier-xxx"> 
<xsl:param name="yyy"/> 
<xsl:param name="zzz"/> 

... corps du modele de transformation ici ... 
</xsl : tempi ate> 

Exemple 

On veut instancier un caractere de rembourrage (un caractere qui sert a completer une 
chalne, a gauche ou a droite, afin de lui donner une longueur totale exactement egale a 
une certaine valeur). 
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Action instancier-bourre 

<!-- 'bourre' : le caractere de rembourrage avec l'espace comme valeur par defaut --> 

<xsl :template name="instancier-bourre"> 

<xsl:param name="bourre" select^ /> 

<xsl :value-of select="$bourre" /> 
</xsl :templ ate> 

L'algorithme de I'instanciation de ce modele de transformation ne doit pas vous sembler 
d'un interet extraordinaire ni d'une difficult^ insurmontable ; mais ce qu'il faut remar- 
quer ici, c'est plutot le nom du modele, qui suit la recommandation indiquee plus haut : 
cette action consistant a instancier de la bourre, on I'appelle « instancier-bourre ». 

A noter que le but premier du rembourrage n'est atteint que si cette action est repetee 
autant de fois que necessaire, mais 5a, c'est un autre probleme: c'est un probleme 
d'iteration, que nous allons voir maintenant. 

Pattern n° 4 - Iteration 

Motivation 

En XPath, il n'y a pas d'instruction pour real iser une iteration sur une action. L'instruc- 
tion xsi : for-each, malgre son nom, n'est pas une instruction d'iteration, mais une ins- 
truction pour changer temporairement de nceud courant. Or il arrive assez frequemment, 
memeen XSLT, qu'il faille iterer une action, notamment lorsqu'on manipuledes chaines 
decaracteres (mais bien entendu, il n'y a pas de domaine reserve). 

II y a deux grandes techniques pour iterer une action; la premiere c'est I 'iteration 
recursive, etl'autre, c'est I 'iteration Piez, du nom deson inventeur. 

Etant donne I'absence d'effet de bord, cela n'aurait aucun sens de vouloir iterer sur un 
appel defonction en XSLT : ceserait comme demander 5000 fois son prenom aquelqu'un. 

Realisation recursive 

L'idee est ici d'envelopper I 'action a iterer dans un modele nomme qui va s'appeler n fois 
recursivement, n etant le nombre d'iterations a effectuer. Si vous n'etes pas tres a I'aise 
avec la recursion, I 'iteration recursive est un bon moyen d'entrer en douceur dans le 
monde fascinant des abymes. Nous aurons I'occasion de detainer la facon de concevoir 
unefonction ou une action recursive, mais ici, il s'agit simplement de repeter n fois une 
action ; le plan etant toujours le meme, il n'y a pas lieu de s'appesantir. 

Ingredients : 

• instancier-xxx : lenom del'action a repeter (sans oublier seseventuels arguments) ; 

• n : le nombre d'iterations demande; 



iter-instancier-xxx : le nom de I'action iterante. 
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Note 

Repeter n fois une action, c'estune action. 0 rune action doit avoir un nomde la forme instancier-xxx. Effec- 
tivement, si I'on suit cette regie, on ne devraitpas nommer Taction iterante iter-instancier-xxx, mais plutot 
instancier-repetitions-de-instancier-xxx. Apres tout, vous faites comme vous voulez, mais moi, je 
prefere la version abregee. 

Model e nomine realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 
<xsl:parain name="n"/> 
<xsl:param name="..."/> 

<xsl :if test="$n > 0"> 

<xsl :call-template name="instancier-xxx"> 

<xsl :with-param name="..." sel ect=" . . . "/> 
</xsl : call -tempi ate> 

<xsl :cal 1 -tempi ate name="iter-instancier-xxx"> 
<xsl :with-param name="n" select="$n - l"/> 
<xsl :with-param name="..." sel ect=" . . . "/> 
</xsl :call-template> 
</xsl :if> 
</xsl : tempi ate> 

II faut remarquer ici que la recursion employee est diteterminale, cequi signifie que lors 
de I'execution de Paction iter-instancier-xxx, I'appel recursif est la derniere instruc- 
tion a etre executee. Cette propriete est extremement avantageuse pour I 'implementa- 
tion : il est inutile de traiter I'appel recursif en tant que tel, et I e processeur XSLT, pour 
peu qu'il sache se livrer a quelques optimisations de base, va pouvoir remplacer I'appel 
recursif par une simple boucle, ce qui sera beaucoup plus economique en terme de 
memoire consommee. 

Evidemment, une variante de ce pattern pourrait etre d'instancier directement des 
instructions XSLT a la place de I'appel a instancier-xxx, comme ceci : 

Modele nomine realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 
<xsl:param name="n"/> 
<xsl:param name="..."/> 

<xsl :if test="$n > 0"> 

<!-- instancier ici directement des instructions XSLT --> 

<xsl :call-template name="iter-instancier-xxx"> 
<xsl :with-param name="n" select="$n - l"/> 
<xsl :with-param name="..." sel ect=" . . . "/> 
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</xsl :call-template> 
</xsl :if> 
</xsl :templ ate> 



Exemple 

iterations.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encoding='IS0-8859-r /> 

<xsl :template name="instancier-bourre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bourre" /> 
</xsl :templ ate> 

<xsl : tempi ate name="iter-instancier-bourre"> 
<xsl rparam name="n"/> 
<xsl:param name="bourre"/> 



<xsl :1f test="$n > 0"> 

<xsl : cal 1 -tempi ate name="instancier-bourre"> 

<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl :call-template> 

<xsl : cal 1 -tempi ate name="i ter-instancier-bourre"> 
<xsl :with-param name="n" select="$n - l"/> 
<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl :call-template> 
</xsl :if> 
</xsl :templ ate> 

<xsl : tempi ate match="/"> 

<xsl : cal 1 -tempi ate name="i ter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl :call-template> 
</xsl :template> 



<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 
Resultat 



L e programme ci-dessus, qui peut etre applique a n'i mporte quel document source XML, 
reprend I'action instancier-bourrevueplushaut(voirPattern n°3-Action, page 398), 
et la repete sept fois, avec le caractere ' . ' comme caractere de rembourrage. 
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Si I'on voulait, il seraittres facile de recuperer leflux de sortie decette instanciation pour 
le rediriger vers une variable : 

Recuperation du flux de sortie dans une variable 

<xsl : tempi ate match="/"> 

<xsl :variable name="rembourrage"> 

<xsl :cal 1 -tempi ate name="iter-instancier-bourre"> 
<xsl :with-parant name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl : call -tempi ate> 
</xsl :variable> 

... utilisation de la variable Srembourrage ... 
</xsl :templ ate> 

Iteration par la methode de Piez 

Cette forme d'iterati on a ete inventee par Wendell Piez, eta ete posteesur la listede dis- 
cussion XSL www.mulberrytech.com/xsl/xsl-list). Elle est basee sur un principe total ement 
different, qui consiste a utiliser ^instruction xsi : for-each, bien qu'elle ne soit pas du 
toutfaite pour 5a. 

Supposons qu'on aitun node-set NS quelconque, pourvu qu'il possede suffisamment de 
nceuds. Suf/zsamment signifie ici au moinsautantdenceuds qu'il y a detours de boucle a 
effectuer, mais il peuty avoir beaucoup plus de nceuds que necessaire, peu importe. 

Soit n lenombre detours de boucle que I 'on veut effectuer. On peutalors real i ser la boucle 
commececi : 

Iteration Piez 

<xsl :for-each select="$NS[ positionO < $n+l ]" > 

<xsl :cal 1 -tempi ate name="instancier-xxx"> 

<xsl :with-param name="..." select=" . . . "/> 
</xsl : call -tempi ate> 

</xsl :for-each> 

L'astuce consiste a utiliser un predicat qui selectionne exactement n noeuds a partir du 
node-set NS. Cela fait, il est clair que I 'instruction xsi : for-each va instancier exactement 
n fois son modelede transformation, et c'est bien la le but de la manoeuvre. 

Reste un leger detail a traiter : comment obtenir un node-set quelconque d'au moins n 
noeuds? II y a evidemment plusieurs reponses possibles. L'une d'entre elles, qui fonc- 
tionne general ement tres bien, est de recuperer les noeuds de I'arbreXM L correspondant 
au programme XSLT lui-meme(qui, nel'oublionspas, estun document XM L commeun 
autre). Cet arbre XML est recuperable grace a la fonction predefinie documento : 
I'appel document ( " ), avec une String vide en argument, renvoie le node-set constitue de 
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la racine de I'arbre X M L du programme X SLT dans lequel die est contenue. U ne fois 
qu'on a la racine, il n'y a plus qu'a selectionner tous les elements enfants, par exemple : 

documentt ' ' )//node( ) 

Evidemment, cela nefonctionnequesi la valeurden n'estpastrop grande. En effet, pour 
desgrandes valeursden, on risque d'avoir un node-set trop petit ; et memesi I 'on s'inge- 
niaitaaller ramasser des nceuds ailleurs, cela deviendrait un peu delirant de constituer un 
node- set enorme, juste pour faire une iteration, alors qu'une iteration classique recursive, 
avec recursion terminale, ne consomme pas de memoi re. 

Exemple 

iterations.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding='IS0-8859-l' /> 
<xsl : variabl e name="Pui tsDeNoeuds" sel ect="document( ' ' )//node( ) "/> 

<xsl : tempi ate name="instancier-bourre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bourre" /> 
</xsl rtempl ate> 

<xsl :template name="iter-instancier-bourre"> 
<xsl:param name="n"/> 
<xsl:param name="bourre"/> 

<xsl :for-each select="$PuitsDeNoeuds[ positionO < $n+l ]" > 
<xsl : cal 1 -tempi ate name="instancier-bourre"> 

<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl :call-template> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate match="/"> 

<xsl :cal 1 -tempi ate name= "iter- ins tancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 
Resultat 



I 
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Pattern n° 5 - Recursion 

Motivation 

Peut-etre pensez-vous que grace aux techniques d' iterati on que nous venons de voir, 
vous allez pouvoir echapper a la recursion. M alheureusement, ce n'est pas vrai : un 
probleme aussi simple que de prendre tous les elements <pn"x devise=" . . . -> d'un 
document XML, et d'en calculer la somme, en tenant compte du taux de change 
actuel, ne peutetre resolu sans recursion, a cause de I ' i mpossi bi I ite qu'il y a de met- 
tre a jour une variable. Avoir une possi bi I ite d'iteration ne resout que la moitie du 
probleme. 

Dans un tel cas, la seule possi bi I ite est d'etablir une definition recursive de la valeur a 
calculer, et de coder cette definition en XSLT. 

II est done indispensable de savoir definir un traitement recursif. 



Realisation 

D'unemanieregenerale, il faut 3 ingredients pour reussir a ecrire une fonction recursive : 

1) un parametre numerique n significatif de la complexite de la mise en ceuvre de cette 
definition, 

2) une solution triviale pour une valeur faible de n, en general 0 ou 1, 

3) un moyen trivial d'obtenir la solution pour la valeur n du parametre, quand on connait 
une solution pour la valeur n-i. 

II peut arriver que le point 1) soit implicite : par exemple une fonction traitant une 
chaine de caracteres peut tres bien reposer sur la longueur de cette chaine, qui 
devient alors implicitement le parametre numerique donnant la complexite de mise 
en ceuvre. 

Un autre point essentiel est qu'il nefaut pas chercher a decrire un algorithme, mais uni- 
quement a definir lafonction ; e'estdeja vrai avec des langagescommejava, C ou Eiffel, 
mais ca I 'est encore pi us en XSLT, qui est assez remarquabledans son pouvoir de rendre 
hermetique ce qui n'est pourtant pas si complique. 

II n'est guere possible de continuer en restant dans les generalit.es ; il faut maintenant 
prendre un exemple. 



Exemple du decompte de mots dans une chaine 

Nous avons une chaine de caracteres constitute de mots separes par un espace. On peut 
supposer que cette chaine est renvoyee par la fonction predefinie normal ize-space( ), de 
sorte qu'il n'y a certainement aucun espace ni en tete, ni en fin, et aucune sequence 
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de plus d'un espacea I'interieur. Le probl erne est de compter les mots, ou, cequi revient 
a peu pres au meme, de compter les espaces. 

II s'agit maintenant de formuler une definition recursive du nombre d'espaces d'une 
chaine : 

nombreEspaces( str ) = 

0 si la chaine str ne contient auncun espace; 

1 + nombreEspaces( substring-after( str, ' ') ) sinon. 

La fonction predefinie substring-after( stri, str2 ) renvoie la sous-chaine de stri 
situeeapresla premiere occurrence de str2 dans stri ; done ici substring-after ( str, 
■ ■ ) va renvoyer la partiede str constitute des caracteres de str situes apres le premier 
espace de str. 

Vous voyez a quel point la definition de cette fonction est simple ; mais surcharged de 
tout lefatras lexical deXSLT, elledevientassez peu lisible: 

Fonction nombreEspaces( str ) 

<xsl :template name="nombreEspaces"> 
<xsl:param name="str"/> 
<xsl :variable name="result"> 
<xsl :choose> 

<xsl:when test="contains( $str, ' ' ) "> 

<xsl ivariable name="nombreEspaces-recursif "> 
<xsl : call -tempi ate name="noinbreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl :value-of select="l + SnombreEspaces-recursi f " /> 
</xsl :when> 
<xsl :otherwise> 

0 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t"/> 
</xsl :templ ate> 

Notez que la definition que nous avons adoptee n'est pas compatible avec le cas favo- 
rable d'une recursion terminale. En effet, la definition recursive de cette fonction pro- 
voque un appel recursif, puis I'addition du resultat obtenu a 1. C'est ce « puis » qui est 
desastreux. 

Pour revenir a une definition qui autorise une recursion terminale, I'astuce consiste gene- 
ral ement a reporter I ecalcul post-appel au niveau des arguments, pour en faireun calcul 
pre-appel. 
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En clair, cela signifie qu'il faut ajouter un nouvel argument, nombre-courant, qui 
contient le nombre d'espaces deja rencontres : 

nombreEspaces( str, nombre-courant ) = 

nombre-courant si la chaine str ne contient auncun espace; 
nombreEspacest substring-after( str, ' '), nombre-courant + 1 ) sinon. 

Pour avoir le nombre d'espaces d'unechaines, on calculenombreEspaces( s, o ). 

LorsdesdifferentsappelsreCUrsifSnombreEspaces( str, nombre-courant ), str represente 

unechalnedeplus en plus courte, et nombre-courant un nombre de pi us en plus grand. 

Remarquons enfin que nous avons fait ici le choix d'une fonction et non d'une action. A 
nouveau, ce choix n'estpas compatible avec une recursion terminal e, puisqu'une fonction 
setermineparun xsi :copy-of. 

Passer d'une fonction a une action est tres simple : il suffit de changer le nom de la fonction 
en nom d'action (instancier-xxx), et de reconstruire les phrases de definition a partir du 
verbe instancier : 

instancier-nombreEspaces( str, nombre-courant ), c'est : 

- instancier nombre-courant si la chaine str ne contient auncun espace; 

- instancier-nombreEspaces( substring-after( str, ' '), nombre-courant + 1 ) 
sinon. 

Action instancier-nombreEspaces( str, nombre-courant ) 

<xsl :template name="instancier-nombreEspaces"> 
<xsl:param name="str"/> 

<xsl:param name="nombre-courant" select=" '0"7> 
<xsl :choose> 

<xsl :when test="contains( $str, ' ' ) "> 

<xsl :cal 1 -tempi ate name=" instancier- nombre Espaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 

<xsl :with-param name="nombre-courant" 
select="l + $nombre-courant"/> 
</xsl : call -tempi ate> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of sel ect="$nombre-courant"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :templ ate> 

Cettefois, on a bien une recursion terminale, qui pourra done etre optimisee en iteration 
par leprocesseurXSLT. Ci dessous, un programme complet, avec les deux methodes. On 
utilise le fait que le parametre nombre-courant possede la valeur 0 par defaut. A insi, lors 
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del'appel initial (voir variable N2, a la fin du programme), il n'estpas besoin de transmettre 
explicitement cette valeur initiale. 

NombreMots.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transforin" 
version="l . 1"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 



<xsl :template name="nombreEspaces"> 
<xsl:param name="str"/> 
<xsl :variable name="result"> 
<xsl : choose> 

<xsl :when test="contains( $str, ' ' ) "> 

<xsl ivariable name="nombreEspaces-recursif "> 
<xsl : call -tempi ate name="nombreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl :value-of select="l + $nombreEspaces-recursi f " /> 
</xsl :when> 
<xsl :otherwise> 

0 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of select="$result"/> 
</xsl :templ ate> 

<xsl :template name="instancier-nombreEspaces"> 
<xsl:param name="str"/> 

<xsl:param name="nombre-courant" select=" '0"7> 
<xsl :choose> 

<xsl :when test="contains( $str, ' ' ) "> 

<xsl :cal 1 -tempi ate name="instancier-nombreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 



<xsl :with-param name="nombre-courant" 
select="l + $nombre-courant"/> 
</xsl :call-template> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="$nombre-courant"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :template> 
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<xsl :variable name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de l'energie 
</xsl :variable> 

<xsl : tempi ate match="/"> 
<xsl :variable name="Nl"> 

<xsl :cal 1 -tempi ate name="nombreEspaces"> 
<xsl :with-param name="str" 

sel ect=" normal ize- space ($compl ainteDuCharretier) "/> 
</xsl :cal 1 -tempi ate> 
</xsl :variable> 

Nombre de mots = <xsl :value-of select="l + $Nl"/> 

<xsl :variable name="N2"> 

<xsl :cal 1 -tempi ate name="instancier-nombreEspaces"> 
<xsl :with-param name="str" 

sel ect=" normal ize- space ($compl ainteDuCharretier) "/> 
</xsl :cal 1 -tempi ate> 
</xsl :variable> 

Nombre de mots = <xsl :value-of select="l + $N2"/> 
</xsl :templ ate> 



<xsl :templ ate match="text( )"/> 



</xsl :stylesheet> 
Resultat 

I Nombre de mots = 10 
Nombre de mots = 10 



Pattern n° 6 -Visiteur recurs if de node-set 

Motivation 

II est tres frequent, en programmation XSLT, que I 'on ait constitue un node-set de noeuds 
possedant unecertaine propriety, et que I'on veuille alorsappliquer un certain traitement 
a chacun de ces noeuds. Par exemple, on peut vouloir calculer la somme des valeurs 
numeriques de ces noeuds (a supposer qu'ils aient effectivement une valeur numerique), 
ou bien faire une statistique quelconque, comme indiquer la valeur minimale, ou la 
moyenne, ou tout autre chose du meme genre. 

II y a bien une fonction predefinie sum( ), qui prend en donnee un node-set, et renvoie la 
somme des noeuds du node-set, a condition bien sflr que la valeur textuelle de ces noeuds 
soit numerique. M ais d'une part, une somme n'est jamais qu'un aspect des choses, et il 
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n'y a pas que des additions dans la vie ; et d'autre part, meme si on veut justement calculer 
une somme, rien ne dit que la fonction sumo soit la bonne solution, car I'experience 
montre que les valeurs a sommer sont rarement purement numeriques. 

Si I'on veut sommer des surfaces (pour des pieces de maison, par exemple), il y a toutes 
les chances que les valeurs se presentent sous la forme « 15m2 », ce qui se traduira par un 
magnifique« NaN » (Not a Number) comme resultat final. 

Typiquement, ce qu'il faut pour resoudre ce genre de probleme de facon generique, c'est 
un visiteur, qui definisse ce qu'est la valeur d'un nceud, la facon de visiter le node-set, et 
I 'action a faire a chaque noeud rencontre. 



Remarque 

II ne s'agit pas ici d'une visite arborescente : on a un node-set, eton se contente de visiter chaque nceud, sans 
alter explorer les descendants de ces nceuds. Ce ne serait pas forcement sans interet, mais a chacun son 
travail : des qu'il s'agit de naviguer dans les arborescences, XPath est la pour ca ; a nous de lui demander un 
node-set qui contienne toutce qu'il nous faut, sans etre oblige definirle travail de navigation. 



Realisation 

Pour real iser un visiteur, il fautd'abord le definir recursivement. Nous allons tout de suite 
faire le choix d'un visiteur sous forme d'action, et nous inspirer de I 'exemple precedent 
pour obtenir une recursion terminale. 

U n visiteur doit renvoyer un resultat, etant donne un node-set ns. Ce resultat sera calcule 
en fonction de la valeur des differents nceuds du node-set ; il faut done supposer qu'on a 
une fonction vaieuro, qui renvoie la valeur d'un nceud. Cette notion de valeur est bi en 
sfir susceptible de changer d'un visiteur a I 'autre, en fonction de la semantique du resultat 
a obtenir. 

On suppose enfin que I'on dispose d'une fonction resuitato, qui prend en donnee un 
resultat parti el et la valeur d'un nceud, et qui renvoie un nouveau resultat partiel, mais 
actual ise en fonction du nceud pris en compte. 

Ceci suggerefortement une partition du node-set a traiter : etant donne un node-set ns, on 
peuttoujoursleconsiderercommeetantforme des nceuds ns[positiono > i] (e'est-a- 
dire, tous les nceuds sauf le premier) et du nceud ns[position( ) = i] (e'est-a-dire, le 
premier nceud). 

L'action a definir sera done I'action instancier-resultat, dont le cas trivial se reduit a 
instancier le resultat partiel auquel on est parvenu : 

instancier-resultat(ns. resultat-courant) , c'est : 

- instancier resultat-courant si ns est vide; 

- instancier-resultatt ns[position( ) > 1], 

resultat( 

resultat-courant, 
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valeur(ns[position( ) = 1]) 

) 

) sinon. 

On peut verifier que cette definition estbien recursive terminal e. 

U ne fois obtenue, el I e doit etre declinee suivant les diverses semantiques possibles 
attachees aux fonctions resuitato et vaieuro. Par exemple la fonction resuitatc ) 
pourra renvoyer le plus petit de ses deux arguments, ou leur somme, ou tout autre 
calcul a partir de ces deux arguments, sachant que le premier represente un resultat 
parti el. 



Application 

Minimum d'un node-set 

Soit par exemple le fichier XML suivant, contenant des descriptions de maisons : 
Maisons.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<maisons> 

<maison id="l"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 
Bibliotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palmier en zinc figurant le desert. </terrasse> 
<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='l'> 
Lambris. 

</al cove> 
</chambre> 

<chambre surface='18m2'> 

Lambris. 
</chambre> 
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<salleDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="2"> 
<RDC> 

<cuisine surface='12m2'> 

en ruine. 
</cuisine> 
<garage/> 
</RDC> 
<etage> 

<mirador surf ace="lm2"> 

Vue sur la mer. Ideal en cas de tempete. 
</mi rador> 

<salleDeBains surface='15m2'> 

Douche. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="3"> 
<RDC> 

<sejour surface='40m2'> 

Les pi an" si rs ont choisi pour asile 
Ce sejour agreable et tranquille. 
Que ces lieux sont charmants 
Pour les heureux amants. 
</sejour> 
</RDC> 
<etage> 

<chambre surface='17.5m2'> 

Exposition plein sud. 
</chambre> 
</etage> 
</maison> 
</maisons> 

On souhaiteconnattrela piece de plus petite surface, parmi toutes les mai sons disponibles. 

Pour cela, nous al Ions mettreen place un visiteur, associe a unefonction vaieurc ) qui va 
renvoyer la valeurcalculeedel'attri but surface, quand il estdisponible, et la valeur sym- 
bolique NaN (Not a Number), quand il est absent. La valeur calculee de cet attri but est la 
chaine privee de I'unite (m2), afin d'obtenir une valeur numerique correcte permettant 
les comparai sons : 

fonction valeurQ 



<xsl :template name="val eur"> 

<xsl:param name="unSingleton"/> 
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<xsl :variable name="result"> <!-- une surface --> 

<xsl :variable name="surface" select="$unSingleton/attribute: :surface"/> 

<xsl :choose> 

<xsl :when test="$surface"> 

<xsl :val ue-of select="substring-before( Ssurface, 'm' )" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl :val ue-of sel ect="number( ' NaN ' ) " /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

Lafonction resuitato sera ici lafonction mim'mumo, avec unesemantiquequi doitres- 

ter COnforme a ce qui a ete defini plus haut : il faut que minimum( minimum-courant, 

nouveiievaieur ) renvoieun nouveau minimum courant, integrant la prise en comptede 
nouveiievaieur, ce qui ne semble pas d'une difficult insurmontable : 

fonction minimum( ) 

<xsl : tempi ate name="minimum"> 
<xsl:param name="vl"/> 
<xsl:param name="v2"/> 

<xsl :variable name="result"> 
<xsl :choose> 

<xsl :when test="string($vl) = 'NaN' and string($v2) = 'NaN'"> 

<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = 'NaN'"> 

<xsl :val ue-of select="$v2" /> 
</xsl :when> 

<xsl :when test="string($v2) = 'NaN'"> 

<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="$vl > $v2"> 

<xsl :val ue-of sel ect="$v2" /> 
</xsl :when> 
<xsl : otherwise) 

<xsl :val ue-of select="$vl" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

M aintenant, il n'y a plus qu'a integrer ceci dans un programme d'essai, et a coder en 

XSLT la definition recursive du Visiteur (nomme instancier-min). 
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SurfaceMini .xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl rstylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encoding='IS0-8859-l' /> 



<! 



> 



<xsl : tempi ate name="val eur"> 

<xsl:param name="unSingleton'7> 

<xsl :variable name="result"> <!-- une surface --> 
<xsl :variable name="surface" 
sel ect="$unSingl eton/attribute: :surf ace"/> 

<xsl :choose> 

<xsl:when test="$surface"> 

<xsl : val ue-of select="substring-before( $surface, 'm' )"/> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="number( 'NaN' )" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

<! -- ============================================================== --> 

<xsl :templ ate name="minimum"> 

<xsl:param name="vl"/> 

<xsl:param name="v2"/> 

<xsl :variable name="result"> 
<xsl :choose> 

<xsl:when test="string($vl) = 'NaN' and string($v2) = 'NaN'"> 

<xsl : val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = 'NaN'"> 

<xsl :value-of select="$v2" /> 
</xsl :when> 

<xsl :when test="string($v2) = ' NaN ' "> 

<xsl : val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="$vl > $v2"> 

<xsl :value-of select="$v2" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl : val ue-of select="$vl" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 
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<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 



<! 



> 



<xsl :template name="instancier-min"> 
<xsl:param name="unNodeSet" /> 
<xsl:param name="min-courant" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl :call-template name="instancier-min"> 
<xsl :with-param name="unNodeSet" 

select="$unNodeSet[position() > l]"/> 

<xsl :with-param name="min-courant"> 
<xsl :call-template name="minimum"> 

<xsl :with-param name="vl" select="$min-courant"/> 

<xsl :with-param name="v2"> 

<xsl : call -tempi ate name="valeur n > 

<xsl :with-param name="unSingleton" 
select="$unNodeSet[position( ) = l]"/> 
</xsl :call-template> 
</xsl :with-param> 
</xsl :call-template> 
</xsl :with-param> 
</xsl : call -tempi ate> 
</xsl :when> 

<xsl :otherwise> 

<xsl :val ue-of sel ect="$min-courant" /> 
</xsl :otherwise> 
</xsl :choose> 

</xsl :templ ate> 

<;-_ ============================================================== --> 

<xsl :template match="/"> 

<xsl :variable name="surface-mini "> 

<xsl :cal 1 -tempi ate name="instancier-min"> 

<xsl :with-param name="unNodeSet" select="//*"/> 
<xsl :with-param name="min-courant" sel ect="1000000"/> 
</xsl :cal 1 -tempi ate> 
</xsl :variable> 

Surface mini = <xsl :val ue-of select="$surface-mini" />m2 
nature de la piece = <xsl :value-of select="local-name( 



//♦[attribute: :surface = 

concat($surface-mini , 'm2')])" /> 



</xsl :templ ate> 



<! 



> 
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<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 
Resultat 

I Surface mini = lm2 
nature de la piece = mirador 

Somme des valeurs d'un node-set 

En conservant le meme fichier X M L, on peut maintenant calculer, pour chaque maison, 
la surface habitable. La fonction vaieuro ne change pas; la fonction resuitato 
devient ici une fonction somme( ), dont le premier argument est la sommedeja obtenue, et 
le deuxieme une nouvelle valeur a sommer. Le visiteur est implements sous le nom 

i nstanci er-somme. 



Surf aceHabi tab! e.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encoding='IS0-8859-l' /> 



<i =============================== 

<xsl :templ ate name="val eur"> 

<xsl:param name="unSingleton"/> 



<xsl :variable name="result"> <!-- une surface --> 
<xsl :variable name="surface" 

select="$unSingl eton /attribute: : surface" /> 

<xsl :choose> 

<xsl:when test="$surface"> 

<xsl :value-of select="substring-before( Ssurface, 'm' )" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl : val ue-of select="number( 'NaN' )" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 



<i_- ======================= 

<xsl : tempi ate name="Somme"> 
<xsl:param name="vl"/> 
<xsl:param name="v2"/> 



<xsl :variable name="result"> 
<xsl : choose> 

<xsl :when test="string($vl) = 'NaN' and string($v2) = 'NaN'"> 
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<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = ' N a N ' " > 

<xsl : val ue-of sel ect="$v2" /> 
</xsl :when> 

<xsl :when test="string($v2) = ' N a N ' " > 
<xsl :val ue-of select="$vl" /> 

</xsl :when> 

<xsl :otherwise> 

<xsl :val ue-of select="$vl + $v2" /> 

</xsl :otherwise> 



<xsl :template name="instancier-soinme"> 
<xsl :param name="unNodeSet" /> 
<xsl:param name="somme-courante" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl :call-template name="instancier-somme"> 
<xsl :with-param name="unNodeSet" 

sel ect="$unNodeSet[position( ) > l]"/> 

<xsl :with-param name="somme-courante"> 
<xsl :cal 1 -template name="Somine"> 
<xsl :with-param name="vl" 

sel ect="$somme-courante"/> 

<xsl :with-param name="v2"> 

<xsl : call -tempi ate name="val eur"> 

<xsl :with-param name="unSingleton" 
select="$unNodeSet[position() = l]"/> 
</xsl :call-template> 
</xsl :with-param> 
</xsl :call-template> 
</xsl :with-param> 
</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :val ue-of sel ect="$somme-courante" /> 
</xsl :otherwise> 
</xsl :choose> 



</xsl :choose> 
</xsl : vari abl e> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 



<! 



> 



</xsl :templ ate> 
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<! 



> 



<xsl : tempi ate match="maison"> 

<xsl :variable name="surface-habitable"> 

<xsl : cal 1 -tempi ate name="instancier-somme"> 

<xsl :with-param name="unNodeSet" select=". //*"/> 
<xsl :with-param name="somme-courante" select="0"/> 
</xsl : call -tempi ate> 
</xsl :variable> 

Maison id = <xsl :value-of select="@id"/> 

Surface habitable = <xsl :value-of sel ect="$surface-habitabl e" />m2 /> 
</xsl :templ ate> 

<j-- ============================================================== -_> 

<xsl :templ ate match="text( ) "/> 

</xsl :stylesheet> 

Resultat 

Maison id = 1 

Surface habitable = 136m2 /> 



Pattern n° 7- Fonction renvoyant plusieurs resultats 

Motivation 

II peut arriver, que dans une fonction un peu compliquee, on ait plusieurs resultats a 
renvoyer, qui sont intimement lies du point de vuealgorithmique. Cela veut dire que si 
I'on voulait renvoyer ces resultats un par un (un par appel), cela reviendrait a relancer 
plusieurs fois le meme calcul ou presque. Pour eviter cela, dans un langage comme C 
ou Java, on ecrit une fonction qui retourne une structure (C) ou un objet (Java). La 
question est done de voir comment ecrire en XSLT une fonction retournant (ou une 
action instanciant) I 'equivalent d'une structure C. 

Realisation 

La solution est d'utiliser element source litteral a contenu calcule, instancie en TST 
(Temporary SourceTree, voir Temporary Source Tree, page 192) : 

Fonction renvoyant trois resultats x, y, z : 



Maison id = 2 
Surface habitable 



28m2 /> 



Maison id = 3 
Surface habitable 



57.5m2 /> 



<xsl :template name="truc"> 
<xsl:param name="..."/> 
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<xsl :variable name="result"> 

<x> 

<xsl : val ue-of select^"..." /> 



</x> 
<y> 



<xsl : val ue-of select^"..." /> 



</y> 
<z> 



<xsl :value-of select^"..." /> 

</z> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl : tempi ate> 
<xsl : tempi ate match=" . . . "> 

<xsl :variable name="a"> 

<xsl :cal 1 -tempi ate name="truc"> 

<xsl :with-param name="..." sel ect=" . . . "/> 

</xsl :cal 1 -tempi ate> 
</xsl :variable> 

<xsl :val ue-of sel ect="$a/x"/> 
<xsl : val ue-of sel ect="$a/y"/> 
<xsl :val ue-of sel ect="$a/z"/> 

</xsl : tempi ate> 



On veut ici une fonction capable de detecter I e premier separateur d'une chaine de carac- 
teres, et de decouper cette chaine en trois morceaux : la partie situee avant le separateur, 
le separateur lui-meme, et la partie situee apres le separateur. On suppose qu'il y a deux 
separateurs possibles : I'espace, et I 'apostrophe. 

C'est pour cela qu'on doitecrire une fonction : s'il n'y avaitqu'un seul separateur a conside- 
red on pourraitutiliser lesfonctions predefines substn'ng-beforeO etsubstring-afterO. 

Nous allons ici reutiliser la fonction index-of vue a la section Exemple, page 397 pour 
obtenir I 'index de chacun des deux separateurs possibles ; le reste vient sans difficulty. 

separateurs.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding=' ISO-8859-1 ' /> 



Exemple 



<xsl :template name="index-of "> 
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<xsl:param name="aString'7> 
<xsl:param name="testString"/> 

<xsl :variable name="result"> 
<xsl : choose> 

<xsl :when test=" contains( SaString, StestString ) "> 
<xsl :variable name="string-Before"> 
<xsl :value-of 

select="substring-before( SaString, StestString )" /> 
</xsl :variable> 

<xsl :value-of select="l+string-length( $string-Before )" /> 
</xsl :when> 

<xsl :otherwise> 
-1 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :template> 

<xsl : tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<!-- separator = apostrophe oil espace --> 

<xsl :param name="stringToSpl it"/> 

<!-- stringToSpl it is space-normalized --> 

<xsl :variable name="indexOf-fi rstApos"> 
<xsl : cal 1 -tempi ate name="index-of"> 

<xsl :with-param name="aString" select="$stringToSplit"/> 
<xsl :with-param name="testString" select='"&apos;"'/> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl :variable name="indexOf-f i rstSpace"> 
<xsl : call -tempi ate name="index-of"> 

<xsl :with-param name="aString" select="$stringToSplit"/> 
<xsl :with-param name="testString" select= /> 
</xsl :call-template> 
</xsl :variable> 

<xsl :variable name="result"> 
<xsl : choose> 

<! > 

<xsl :when test=" SindexOf-firstApos < $indexOf-f i rstSpace "> 
<before> 

<xsl :val ue-of select="substring( SstringToSpl it, 1, 
$indexOf-fi rstApos - 1 )" /> 

</before> 

<separator>' </separator> 
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<after> 

<xsl :value-of sel ect="substring( SstringToSplit, 

SindexOf-firstApos + 1 )" /> 

</after> 
</xsl :when> 

<! > 

<xsl :when test=" SindexOf-firstSpace < $indexOf-fi rstApos "> 
<before> 

<xsl :value-of select="substring( 

SstringToSplit, 1, 
SindexOf-firstSpace - 1 )" /> 

</before> 

<separator><xsl :text> </xsl :text></separator> 
<after> 

<xsl :value-of select="substring( 

SstringToSpl it, 
SindexOf-firstSpace +1 )" /> 

</after> 
</xsl :when> 

</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

<xsl :variable name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de l'energie ! 
</xsl :variable> 

<xsl :variable name="pendule"> 

L'heure exacte. 
</xsl :variable> 

<xsl : tempi ate match="/"> 

<xsl :variable name="spl itl"> 

<xsl :cal 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl :with-param name="stringToSplit" 
sel ect=" normal ize- space (Scompl ainteDuCharretier) "/> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl :val ue-of sel ect=" normal ize-space( Scompl ainteDuCharretier)"/> 
before = <xsl :value-of select="Sspl itl/before"/> 
separator = "<xsl :value-of select="Sspl itl/separator"/>" 
after = <xsl :val ue-of sel ect="Sspl itl/after"/> 

<xsl :variable name="spl it2"> 

<xsl :cal 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl :with-param name="stringToSplit" 
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sel ect=" normal ize-space($pendul e)"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl :text> 

</xsl :text> 

<xsl : val ue-of sel ect=" normal ize-space($pendul e) "/> 
before = <xsl :value-of select="$split2/before"/> 
separator = "<xsl :value-of sel ect="$spl it2/separator"/>" 
after = <xsl :value-of select="$spl it2/after"/> 

</xsl :template> 

<xsl :template match="text( ) "/> 
</xsl :stylesheet> 
Resultat 

Pousser des charettes a longueur de journee reclame de l'energie ! 
before = Pousser 
separator = " " 

after = des charettes a longueur de journee reclame de l'energie ! 

L'heure exacte. 

before = L 
separator = "'" 
after = heure exacte. 



Pattern n° 8- Utilisation d une structure de donnees auxilaire 

Motivation 

XSLT est un langagedont la description ne fait jamais appel defacon evidentea la notion 
de structure de donnees manipulate par telle ou telle instruction. En Java ou d'autres 
langages, il y a touj ours touteunepanopliede structures possibles (tableaux, listes, piles, 
etc.), maispas en XSLT. 

X SLT ne connait que la notion d'arbre XML; done, en acceptant la structure d'arbre comme 
structure de donnees universelle, on peut se raccrocher aux branches, et parvenir a ses fins. 

En effet, un arbreXM L, en tantqueTST accroche a une variable peutjouer le roled'une 
structure de donnees (non modifiable, comme d'habitude en XSLT) : une fois I'arbre 
construit dans une variable, on peut utiliser des expressions X Path pour le parcourir et 
extraire les informations utiles. Et si cet arbreXM L est un peu trop volumineux ou com- 
plexe pour que les recherches y soient efficaces, rien n'empeche d'y indexer certaines 
valeurs par unecle (xsi :key). 
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Exemple 



Dans cet exemple, nous allons montrer comment mettre en ceuvre une structure de don- 
nees indispensable au traitement. II s'agit de renumeroter sequentiellement des identi- 
fiants numeriques de pages d'une presentation video-projetable specifiee en XM L. Un 
exemple abrege d'un tel fichier XML pourrait etre celui-ci : 

presentation.xml 

<?xml version="1.0" encoding="UTF-16" ?> 

<presentation> 

<pageDeTitre id="CoursXML.l" next="CoursXML.2"> 

<titrePresentation>Comprendre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML.l" next="CoursXML.3"> 
<titre level="l" id="CoursXML.2.Deroulement"> 
Deroulement du Cours</titre> 

</pageStandard> 



<plan id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.4.1"> 

<titre level="l" id="CoursXML.4. XMLgeneral "> 

XML - Generalites </titre> 

</pageStandard> 



<pageStandard id="CoursXML.4.1" prev="CoursXML.4" next="CoursXML.4.2"> 

<titre level="2" id="CoursXML.4.1. Langagesdebal i sage"> 

Les langages de balisage </titre> 

<bloc> 

<figure src="ArbreXML_l" id="fig:ArbreXML_l.CoursXML.4.1"> 

<captionFigure> 

Structure arborescente d'un document XML bien forme 

</captionFigure> 
</figure> 
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</bloc> 
</pageStandard> 



<pageStandard id="CoursXML.4.2" prev="CoursXML.4. 1" next="CoursXML.5"> 
<titre level="2" id="CoursXML.4.2._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 

</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4.2" next="CoursXML.6"> 

<titre level="l" id="CoursXML.5. StructuredocumentXML"> 

Structure d'un document XML </titre> 



<bloc> 

Ces blocs juxtaposes ou imbriques forment un arbre 
<cf Figure cf="fig:ArbreXML_l.CoursXML.4.1"/> 
comme tout document XML. 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.6" prev="CoursXML. 5" next="CoursXML.7"> 
<titre level="2" id="CoursXML.6._DTD"> 
Grammaire d'un document XML (DTD) 
</titre> 

</pageStandard> 

<pageFin id="CoursXML.7" prev="CoursXML. 6" /> 
</presentation> 

De temps en temps, on ajouteou suppri me des pages entre deux, cequi fait que lesnume- 
ros d'identi fiant des pages finissent par etre assez eloignes de I'ordre naturel. La renu- 
merotation consiste a retablir I'ordre naturel, sachant qu'il y a des repercussions sur 
d'autres identifiants, comme ceux des titres, ou des figures, et par voie de consequence, 
les references aux figures. 

Le resu I tat attend u de la transformation XSLT est done celui-ci : 

presentation -new .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<presentation> 

<pageDeTitre id="CoursXML.l" next="CoursXML.2"> 
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<titrePresentation>Comprendre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML.l" next="CoursXML.3"> 
<titre level="l" id="CoursXML.2._"> 
Deroulement du Cours</titre> 

</pageStandard> 



<pl an id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.5"> 

<titre 1 evel ="l" id="CoursXML.4. XMLgeneral"> 

XML - Generalites </titre> 

</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4" next="CoursXML.6"> 

<titre 1 evel ="2" id="CoursXML.5. Langagesdebal isage"> 

Les langages de balisage </titre> 

<bloc> 

<figure src="@src" id="fig:ArbreXML_l.CoursXML.5"> 
<captionFigure> 

Structure arborescente d'un document XML bien forme 
</captionFigure> 
</figure> 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.6" prev="CoursXML.5" next="CoursXML.7"> 
<titre level="2" id="CoursXML.6._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 

</pageStandard> 



<pageStandard id="CoursXML.7" prev="CoursXML. 6" next="CoursXML.8"> 
<titre 1 evel id="CoursXML.7. StructuredocumentXML"> 
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Structure d'un document XML </titre> 



<bloc> 

Ces blocs juxtaposes ou imbriques torment un arbre 
<cf Figure cf="fig:ArbreXML_l.CoursXML.5"/> 
comme tout document XML. 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.8" prev="CoursXML.7" next="CoursXML.9"> 
<titre level="2" id="CoursXML.8._DTD"> 
Grammaire d'un document XML (DTD) 
</titre> 

</pageStandard> 

<pageFin id="CoursXML.7" prev="CoursXML. 6"/> 



</presentation> 

Le probleme est done ici de garder en memoire une table de correspondance entre les 
anciens id et les nouveaux. Ayant une telle table, a chaquefois qu'on a un id a changer, 
on va chercher le nouvel id correspondant a I'ancien, ce qui nous permet de former une 
nouvellechainedecaracteresa parti r de ce nouvel id. 

Par exemple, ayant I'identifiant fig:ArbreXML_i.coursXML.4.i, on en extrait cours- 
xml.4.1 ; la table nous donne la correspondance de cet identi fiant avec 5, ce qui nous 
permet de former I'identifiant -fig:ArbreXML_i.coursXML.5". 

De meme, a parti r de coursXML.4 . 1, on obtient a nouveau 5, done a parti r de 5+1 et de 5-1, 
on forme respectivement les identi fiants next (coursXML.6) et prev (coursXML.4). 

La realisation de cette table consiste a creer un arbre XM L contenant toutes les paires 
(ancien id , nouvel id) conservees par exemple en tant qu'attributs d'un element 
<page> qui sera repete autant de fois qu'il y a de pages declarees dans la <presentation> 

(ce qui indut tOUteS les SOrteS de pages: <pageDeTitre>, <plan>, <pageStandard>, 
<pageFi n>). 

On peut done faire eel a de cette maniere : 

Constitution de la table de correspondance 

<xsl :variable name="lesPages"> 
<pages> 

<xsl :for-each select="/presentation/*"> 
<page> 

<xsl :attribute name="id"Xxsl :value-of select="@id"/X/xsl :attribute> 
<xsl :attribute name="newld"> 
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<xsl :value-of select="position()"/> 
</xsl :attribute> 
</page> 
</xsl :for-each> 
</pages> 
</xsl :variable> 

Cette variable sera une variable globale, ce qui veut dire qu'elle sera evaluee avec le 
nceud racinecommenoeud contexte; avec lefichier presentation. xmi montre ci-dessus, 
I'arbre genere sera lesuivant: 

Arbre genere lors de 1 'evaluation de cette variable 

<pages> 

<page id="CoursXML.l" newld="l'7> 
<page id="CoursXML.2" newld="2'7> 
<page id="CoursXML.3" newld="3'7> 
<page id="CoursXML.4" newld="4'7> 
<page id="CoursXML.4.1" newld="5'7> 
<page id="CoursXML.4.2" newld="6'7> 
<page id="CoursXML.5" newld="7'7> 
<page id="CoursXML.6" newld="8'7> 
<page id="CoursXML.7" newld="9'7> 
<pages> 

On peut tout de suite mettre au point un modele nomme qui permettra d'instancier le 
newiD connaissant I'id : 



Arbre genere lors de devaluation de cette variable 

<xsl :template name='instancier-newID'> 
<xsl:param name='oldId'/> 
<xsl :value-of sel ect="$l esPages/pages/page[ 

attribute: :id = $o! did 
]/attribute: :newld" /> 

</xsl : tempi ate> 



Remarque 

On utilise ici le faitqu'une variable contenantunTST est implicitement convertie en node-set lorsqu'elle estrefe- 
rencee. On rappelle que ceci n'estpas conforme au standard XSLT 1.0, mais que c'estune proposition qui sera 
selon toute vraisemblance integree au standard XSLT 2,0. Voir a ce sujet la section Operations sur un TST 
(XSLT 1.1 ou plus), page 198. 



Ceci etant, on quitte maintenant le domaine du pattern pour entrer dans le specifique, 
puisqu'il s'agit de real iser la transformation demandee (le pattern ne concerne que la 
facon de real i ser une structure de donnees). M ais en fait, si on quitte le domaine du pat- 
tern, c'est pour y revenir aussitot, car ce qu'on a a faire maintenant est une copie presque 
conforme du document (pour s'en convaincre, il suffitde comparer le document source et 
le resultat attendu : au premier coup d'ceil, on ne voit pas de difference, car seules les 
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parties numeriques des identifiants changent d'un document a I'autre). Or une copie 
presque conforme, c'est un des patterns de transformation, que nous verrons done dans le 
chapitre qui leur estconsacre. 

Si I'on s'interesse dans un premier temps uniquement a la facon de modifier les attributs 
d'une <pagestandard>, on va commencer par ecrire une regie qui exploite cette table de 
correspondanceen utilisant le modele nomme instancier-newiD : 

Modification des attributs d'une pageStandard 



<xsl :template match='pageStandard'> 
<pageStandard> 

<xsl :variable name="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 

<xsl :with-param name='oldId' select="@id" /> 
</xsl :call-template> 
</xsl :variable> 

<xsl :attribute name="id">CoursXML.<xsl :val ue-of sel ect="$NoSeq" /> 
</xsl :attribute> 

<xsl :attribute name="prev">CoursXML.<xsl :value-of sel ect="$NoSeq - l"/> 
</xsl :attribute> 

<xsl :attribute name="next">CoursXML.<xsl :value-of sel ect="$NoSeq + l"/> 
</xsl :attribute> 

</pageStandard> 
</xsl :templ ate> 

On aura exactement le meme traitement pour la page special e <pi an>, et des regies voi sines 
pour une <pageDeTi tre> et une <pageFi n>, ce qui nous amene a ceci : 



Modification des attributs d'une pageStandard ou d'un plan 

<xsl :template match='pageStandard | pi an ' > 
<xsl :el ement name="{ local -name( . ) }"> 
<xsl rvariable name="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 

<xsl :with-param name='oldId' select="@id" /> 
</xsl :call-template> 
</xsl :variable> 

<xsl :attribute name="id">CoursXML.<xsl :val ue-of sel ect="$NoSeq" /> 
</xsl :attribute> 

<xsl :attribute name="prev">CoursXML.<xsl :value-of sel ect="$NoSeq - l"/> 
</xsl :attribute> 

<xsl :attribute name="next">CoursXML.<xsl :value-of sel ect="$NoSeq + l"/> 
</xsl :attribute> 



<xsl :apply-templates/> 
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I</xsl :element> 
</xsl : tempi ate> 

Modification des attributs d'une pageDeTitre 

<xsl :template match='pageDeTitre'> 

<!-- idem sans l'attribut prev --> 
</xsl : tempi ate> 

Modification des attributs d'une pageFin 

<xsl :template match='pageDeTitre'> 

<!-- idem sans l'attribut next --> 
</xsl : tempi ate> 

M aisil ne suffit pasderecopier une page (i.e. un element du genre page) en secontentant 
de generer des attributs modifies: encore faut-il copier ses enfants directs comme 
<titre> ou <bioc>, ce qui pourra etre fait par des regies dediees a chacun de ces ele- 
ments. C'est pourquoi le modele de transformation se termine par un <xsi:appiy- 
tempiates/>, qui va relancer les regies concernees. 

Mise en place de regies specifiques pour les enfants d'une page 

<xsl :template match='titre'> 
<titre> 

</titre> 
</xsl : tempi ate> 

<xsl :template match='figure'> 
<figure src="@src"> 

</figure> 
</xsl : tempi ate> 

<xsl :template match='cfFigure'> 
<cfFigure> 

</cf Figure> 
</xsl : tempi ate> 

Dans chacune de ces regies, on effectue un traitement similaire a celui d'une page pour 
former et generer les nouvelles valeurs d'attributs identifiants. 

Le probleme est maintenant de voir comment I 'ensemble s'articule. Le processus de 
traitement demarre sur la racine, pour laquelle aucune regie n'est prevue. La regie par 
defaut va done s'appliquer, ce qui va produire un node-set ne contenant que I 'element 
<presentation>, et relancer toute la mecanique sur ce node-set. A nouveau, la regie 
par defaut sera selectionnee, car il n'y a aucune regie specifique pour une <presenta- 
tion>. M ais cette fois, ce n'est pas souhaitable, car I'element <presentation> ne peut 
pas etre traite par defaut: il faut le recopier. Plus generalement tout element pour 
lequel une regie specifique n'existe pas (typiquement, il s'agit des elements qui n'ont 
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pas d'attributs concern.es par la renumerotation, ou pas d'attribut du tout) doit etre 
traite non pas par defaut, mais par une regie qui va le recopier sans modification. II faut 
done avoir une regie « ramasse-tout » de recopie (pour des explications comple- 
mentaires concernant cette regie, voir le pattern « Copie non conforme », a la section 
Pattern n° 10 - Copie non conforme, page 443) : 

Regie de recopie ramasse-tout 

<xsl :templ ate match='*'> 
<xsl :copy> 

<xsl :apply-templates sel ect='@*| node( ) ' /> 
</xsl :copy> 
</xsl :templ ate> 

Voici done maintenant le programme complet : 

renumeroter.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.1"> <!-- compatibility Saxon 6.5 --> 



<xsl:output method='xml ' encoding=' ISO-8859-1' /> 



<xsl :variable name="lesPages"> 
<pages> 

<xsl :for-each select="/presentation/*"> 
<page> 

<xsl :attribute name="id"Xxsl :val ue-of select="@id"/> 
</xsl :attribute> 

<xsl attribute name="newld"><xsl :value-of select="position( )"/> 

</xsl :attribute> 

</page> 
</xsl :for-each> 
</pages> 



</xsl :variable> 



<xsl rtemplate name=' instancier-newID'> 
<xsl:param name='oldId'/> 
<xsl :value-of sel ect="$l esPages/pages/page[ 

attribute: :id = Soldld 
]/attribute: :newld" /> 

</xsl :templ ate> 

<xsl :template match^'pageStandard | plan'> 
<xsl :el ement name=" {local -name( . ) } "> 
<xsl :variable name="NoSeq"> 

<xsl :call-template name='instancier-newID'> 
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<xsl :with-param name='oldId' select="@id" /> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl rattribute name="id">CoursXML.<xsl :val ue-of 

sel ect="$NoSeq" /></xsl :attribute> 
<xsl :attribute name="prev">CoursXML.<xsl :value-of 

select="$NoSeq - l"/X/xsl :attribute> 
<xsl :attribute name="next">CoursXML.<xsl :value-of 

sel ect="$NoSeq + 1" /></xsl :attribute> 

<xsl :apply-templates/> 
</xsl :el ement> 
</xsl :templ ate> 

<xsl :template match='pageDeTitre'> 

<xsl :el ement name=" {1 ocal -name( . ) }"> 
<xsl :variable name="NoSeq"> 

<xsl :call-template name='instancier-newID'> 

<xsl :with-param name='oldId' sel ect="@id" /> 
</xsl : cal 1 -tempi ate> 
</xsl :variable> 

<xsl rattribute name="id">CoursXML.<xsl :val ue-of 

sel ect="$NoSeq" /></xsl :attribute> 
<xsl rattribute name="next">CoursXML.<xsl :value-of 

sel ect="$NoSeq + 1" /X/xsl :attribute> 

<xsl :apply-templates/> 
</xsl :el ement> 
</xsl :templ ate> 

<xsl :template match='pageFin'> 

<xsl :el ement name=" {1 ocal -name( . ) }"> 
<xsl :variable name="NoSeq"> 

<xsl :call-template name='instancier-newID'> 

<xsl :with-param name='oldId' select="@id" /> 
</xsl :call-template> 
</xsl :variable> 

<xsl : attribute name="id">CoursXML.<xsl :val ue-of 

sel ect="$NoSeq" /X/xsl :attribute> 
<xsl attribute name="prev">CoursXML.<xsl :value-of 

sel ect="$NoSeq - 1" /X/xsl :attribute> 

</xsl :el ement> 
</xsl :templ ate> 

<xsl :template match='titre'> 



<titre> 
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<xsl :vari abl e name="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 
<xsl :with-param name='oldId' 

select="parent: :pageStandard/attribute: :id" /> 
</xsl :call-template> 
</xsl :variable> 



<xsl :variable name="texteID" select='substring-after(@id, 

<xsl attribute name="l evel "> 

<xsl :value-of select="@level " /> 
</xsl :attribute> 

<xsl attribute name="id"> 

<xsl :text>CoursXML.</xsl :text> 

<xsl :val ue-of select="$NoSeq" /> 

<xsl :text>. </xsl :text> 

<xsl :val ue-of select="$texteID" /> 
</xsl :attribute> 

<xsl :apply-templates/> 



_")'/> 



</titre> 
</xsl :templ ate> 



<xsl : tempi ate match='figure'> 

<figure src="@src"> 

<xsl : vari abl e name="NoSeq"> 

<xsl :cal 1 -tempi ate name='instancier-newID'> 
<xsl :with-param name='oldId' 

sel ect="ancestor: :pageStandard/attribute: :id"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl : vari abl e name="texteID" select='substring-before(@id, ".")' /> 

<xsl attribute name="id"> 

<xsl :val ue-of select="$texteID" /> 

<xsl :text>.CoursXML.</xsl :text> 

<xsl :val ue-of select="$NoSeq" /> 
</xsl :attribute> 



<xsl :apply-templates/> 
</figure> 
</xsl :templ ate> 
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<xsl : tempi ate match='cfFigure'> 



<cf Figure> 

<xsl :variable name="NoSeq"> 

<xsl :call-template name='instancier-newID'> 
<xsl :with-param name='oldId' 

select="substring-after(@cf , ' . ' )"/> 

</xsl : call -tempi ate> 
</xsl :variable> 



<xsl :variable name="texteID" select='substring-before(@cf , ".")' /> 



<xsl :attribute name="cf"> 

<xsl :value-of select="$texteID" /> 
<xsl :text>.CoursXML.</xsl :text> 
<xsl :value-of select="$NoSeq" /> 
</xsl :attribute> 
</cfFigure> 
</xsl : tempi ate> 



<xsl : tempi ate match='*'> 
<xsl :copy> 

<xsl :apply-templates select='@*|node( ) ' /> 
</xsl :copy> 
</xsl :templ ate> 



</xsl :stylesheet> 

Ce programme fonctionne avec Saxon, qui accepte les evolutions prevues dans le W3C 
Working DraftXSLT 1.1. Avec un processeur qui s'en tientau standard XSLT 1.0, il faut 
utiliser unefonction d'extension pour convertir explicitementen node-set I e RTF renvoye 
par la reference a la variable l esPages ; les modifications concernent la declaration de la 
feuillede style, et le modele nomme instancier-newiD. Le resteest inchange. 

Modifications pour utiliser la fonction d'extension nodeset 

<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
xmlns:xalan="http://xml .apache.org/xalan" 
excl ude-resul t-pref ixes="xal an" 
version = "1.0"> 

<xsl :template name='instancier-newID'> 
<xsl:param name='oldId/> 

<xsl :value-of select="xalan:nodeset($lesPages)/pages/page[ 

attribute: :id = $oldId]/attribute: :newld" /> 

</xsl :templ ate> 

II pourraetre interessantderevenir a ce programme apres avoir vu le pattern « Copie non 
conforme », a la section Pattern n° 10 - Copie non conforme, page 443. 
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Pattern n° 9 - Identite de nceuds et node-set de valeurs 
toutes differentes 

Motivation 

II peut arriver que I'on ait a tester I 'identite de deux nceuds pour savoir si ce sont les 
memes ou non. 

II y a alors deux choses a savoir : la premiere, c'est ce que signifie I 'identite de deux 
nceuds, et comment une situation ou il y a identite peutseproduire ; la deuxieme, c'est de 
savoir comment s'y prendre pour real iser un tel test. 

M ais avant cela, il est indispensable, arrive a ce point, de bien expliciter le rapport qu'il y 
a entre les node-sets que I'on manipule au travers d'expressions XPath et les nceuds 
qu'ils contiennent. On seplacedans lecassimpleou I'on a un arbreXM L (I'arbreXM L 
du document source), mais pas de variable attachee a un TST, ni de document XML 
secondaire accessible par la fonction documentc ). 

Supposons maintenant que nous ayons constitue deux node-sets, grace a deux expressions 
XPath quelconques. Que contiennent exactement ces node-sets ? 

Certainement pas une copie des nceuds de I'arbre XM L, car le nombre de nceuds total 
dans le systeme ne varie pas au cours de I 'execution (tout au moins dans I'hypothese 
expl icitee ci-dessus) : ce nombre est eel ui de I'arbre source XM L. 

Sont-ce alors les nceuds originaux ? 

Pas plus, car cela voudrait dire que si un nceud etait contenu dans un certain node-set, il 
neserait plus disponible pour faire partie d'un autre node- set, cequi est absurde. 

La reponse est d'ordre mathematique : en mathematiques, les ecritures comme x, y, N, 
designent des objets mathematiques qui peuplent I' uni vers mathematique, etqui existent 
chacun en un seul exemplaire. II n'y a pas plusieurs nombre un, il n'y en a qu'un ; mais 
il y a une infinite d'ecritures designant ce nombre, parmi lesquelles, 1, 0+1, 2/2, x tel que 
x solution de I 'equation x = 1, y tel que y solution de I 'equation y = 1, etc. Avec les deux 
dernieres ecritures, on peut dire que x = y, parce que x et y sont deux ecritures qui 
designent le meme nombre (un, en I 'occurrence). 

La meilleure representation qu'on puisse se faire d'un node-set est basee sur la meme 
idee: un node-set contient des choses qui refe'rencent les nceuds de I'arbreXM L source, 
mais pas les nceuds eux-memes, ni encore moins une copie. Cela s'implemente evidem- 
ment sous la forme de pointeurs, mais i I est a noter que I e standard XSLT ne pari e jamais 
de pointeurs, qui sont des notions d'implementation, et seraient plutot mal venues dans 
une specification. La figure 8-1 donne une representation graphique du lien entre un 
node-set et les nceuds qu'il contient. 

Imaginons maintenant que I'on veuille constituer un node-set contenant les surfaces des 
pieces du RDC (toujours en se reportant a la figure 8-1). 
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/maison/RDC/* [not (@surface) ] / /maison/RDC/bureau 



root- 

/ 




attribute -7 

\ surface / 

\ 40m2 / 



attribute 

\ surface 

\ 40m2 



text 




text 


Evier inox. 




Lavabo. 


M obilier 




Cumulus 


encastre. 




200L. 



text 

Cheminee en 

pierre. 
Poutres au 
plafond. 
Carrel age terre 

cuite. 
Grande baie 
vitree 



attribute 

surface 

15m2 



text 

Bibliotheque 
encastree. 



Figure 8-1 

Deux node-sets partageant un naud commun. 



On pourraitetretente d'ecrire : 

Node-set des surfaces 

<xsl :variable name="x" select="/maison/RDC/*/attribute: :surface"/> 

Cequi n'est pas forcement faux. M aisest-cebien cequ'on voulait ? Si le butetait d'obte- 
nir un node-set ne contenant que des surfaces differentes les unes des autres (apres tout, 
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un ensemble necontientbi en que des elements differents I es uns des autres, non ?), c'est 
rate. Le node-set $x contient trois elements, correspondant aux surfaces 40m 2 , 40m 2 , 
15m 2 . Mors? Quese passe-t-il ? 

C'est tres simple a voir graphiquement (voir figure 8-2). 



/maison/RDC/* /attribute : : surface 





attribute 

surface 

40m2 



— text — 




- text -, 


Evier inox. 




Lavabo. 


M obilier 




Cumulus 


encastre. 




200L. 



text 

Cheminee en 

pierre. 
Poutres au 
plafond. 
Carrelageterre 

cuite. 
Grande baie 
vitree 



— text — 

Bibliotheque 
encastree. 



Figure 8-2 

Un node-set d'attributs. 
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Le node-set ainsi constitue a bien trois elements, parce qu'il y a bien trois attributs dans 
I'arbre XML. Que deux d'entre eux aient la meme valeur textuelle ne change rien a 
I'affaire : il y a trois attributs, et rien ne peut detruire cette certitude. 

Nous avons done repondu a la premiere question, qui etait de savoir ce qu'est la notion 
d'identite : deux noeuds d'un node-set sont identiques s'ils referenced le meme nceud de 
I'arbreXML. 

M ais la deuxieme question reste en suspens : comment faire pour tester I 'identite de deux 
noeuds ? Et nous venons d'ajouter une question supplemental re : comment faire pour consti- 
tuerun node-sets de surfaces, e'est-a-direun node-set de noeuds de valeurs toutes differentes? 

C 'est ce que nous al I ons voi r mai ntenant. 

Realisation 

Tests d'identite 

II n'y a que deux moyens de real iser un test d'identite en XSLT : soit on emploie I'ope- 
rateur "|" (barre verticale) qui realise I'union ensembliste de deux node-sets, soit on 
utilise la fonction predefinie generate-id( ), qui comme son nom I'indique, retourne 
un identifiant pour le nceud qui lui est transmis (explicitement, ou implicitement si 
e'est le nceud contexte). 

Pour simplifier et se concentrer sur le principe, on peut supposer que le test d'identite va 
s'appliquer a deux node-sets NS1 (ne contenant qu'un seul nceud nl) et NS2 (ne conte- 
nant qu'un seul noeud n2). Le test d'identite des noeuds nl et n2 peut alors etre applique 
aux node-sets NS1 et NS2, chose indispensable en XSLT puisqu'on ne peut manipuler 
que des node-sets. 

Tests d'identite 

count( $NS1 | $NS2 ) = 1 

generate-id( $NS1 ) = generate-id( $NS2 ) 

Le deuxieme test est direct : generate-ido renvoie un identifiant sur le premier nceud du 
node-set qui lui est transmis; la specification de cette fonction garantit que si I es i denti fiants 
sont egaux (en tant que chaines de caracteres), alors I es noeuds transmis sont confondus. 

L e premier test est un peu plustordu, mais constitue une expression X Path idiomatique : 
si NS1 et N S2, deux singletons, ontunereunion dontle cardinal reste egal a 1, e'estqu'ils 
contiennent lememeelement (au sens del 'identite que nous avons vu plus haut), e'est-a- 
dire qu'ils partagent le meme element (voir figure 8-1 ). 

Dans la meme veine, on a le test d'appartenance vu a la section Appartenance et test 
d'inclusion, page 44 ($N represente un node-set ne contenant que le noeud dont I 'appar- 
tenance a $N S est a tester) : 



Tests d'appartenance 

count( $N | $NS ) = count( $NS ) 
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Node-set de valeurs toutes differentes 

Methode du preceding-sibling 

Pour le node-set de surfaces, c'est un peu plus complique. En toute logique, il fau- 
drait exprimer le node-set sous forme d'une expression X Path qui dise quelque chose 
du genre : 

I/maison/RDC/*/attribute: :surf ace[ 
la valeur textuelle de . n'existe pas deja dans le node-set en construction 

Remarque 

Ne pas oublier que dans cette expression, le « . » represente le nceud contextede revaluation du predicat : c'est 
done tour a tour chacun des nceuds de Pensemble /maison/RDC/*/attribute: : surface. Pour chacun de ces 
nceuds, on teste si sa valeur textuelle etc., etc. : si oui, on garde le nceud dans le node-set en construction, 
sinon, on le rejette. 

M alheureusement, une telle expression n'est pas traduisible en X Path, parce qu'il n'y 
a aucun moyen de referencer le node-set en cours de construction. II faut contourner 
le probleme en trouvant une facon de dire la meme chose sans parler de node-set en 
construction : 

/maison/RDC/*/attribute: :surf ace[ 

la valeur textuelle de . n'existe pas deja dans un certain node-set NS 

] 

Cette expression est cette fois traduisible en XPath, mais le probleme reste entier : com- 
ment trouver le node-set NS ? En tri chant un peu, on peutarriver a en trouver un. En effet 
les nceuds portant les attributs surface sonttous des enfants d'un element unique <rdc> 
(si tant est qu'il n'y ait pas plusieurs rez-de-chaussee dans une mememaison, et qu'il n'y 
ait pas plusieurs elements <maison> accroches a la racine). 

Done dans devaluation du predicat ci-dessus, le nceud contexte se deplace de proche en 
proche sur des nceuds surface qui sont portes par des elements de I'axe child: : * done 
des elements qui sont selectionnes dans I 'ordre de lecture du document. 

La solution qu'on peut alors tenter de mettre en ceuvre decoulede la remarque suivante : 
puisque les elements sont selectionnes dans I 'ordre de lecture du document, les elements 
deja traites dans I 'evaluation du predicat sont ceux qui se trouvent dans le node-set 
preceding-sibling: :* relatif a I'element en cours de test. Avec cette idee, la pseudo- 
expression X Path ci-dessus devient : 

I/maison/RDC/*[ la valeur textuelle de ./attribute: :surface n'existe pas deja dans 
preceding-sibl ing: :*/attribute: : surface ] /attribute: : surface 

Ce qui donne, en bon X Path : 

Creation d'un node-set de surfaces toutes differentes 



/maison/RDC/*[ not( ./©surface = preceding-sibl ing: :*/@surface ) ]/@surface 
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La encore, cette expression, quoiqu'un peu complexe, est assez idiomatique. On la 
retrouve sous diverses formes, notamment dans les transformations XSLT comportant 
des regroupements (voir Pattern n° 14- Regroupements, page 474). 

A chaque fois, on exploite la propriete selon laquelle un element se trouvant dans 
preceding-sibi ing: :* se trouve aussi necessai rement dans le node-set en cours de 
construction, ce qui donne une approximation du node- set en cours de construction. 

A noter que la construction d'un node-set d'au plus n elements, avec ce genre de predi- 
cat, est une operation pouvant demander n(n-l)/2 comparaisons dans les cas les moins 
favorables, parce que plus on avance, plus il y a du mondederriere, et done plus I'explo- 
ration de preceding-sibling: :* est longue. 

Methode du regroupement par cle 

U ne autre methode existe pour etablir un tel node-set. Cette methode a ete inventee par 
Steve M uench, de la societe Oracle (quelqu'un de tres actif dans le domaine de XSLT). 
L'idee est de partir de node-sets obtenus par la fonction keyo, appliquee a une cle 
regroupant les valeurs identiques, comme indique sur la figure 8-3. 

Si, dans la situation schematised par la figure 8-3, on appelle la fonction keyo avec 
« 40m 2 » comme deuxieme argument, on obtient en retour un node-set d'attri buts dont 
lesvaleurstextuellessonttoutesegalesa« 40m 2 » ; deplusil est certain quecegroupede 
surfaces contient toutes les surfaces de« 40m 2 » (il n'en manque aucune). 

Pour obtenir le node-set des surfaces toutes differentes, il suffit done de prendre un et 
un seul noeud dans chaque groupe de surfaces, e'est-a-dire le premier nceud de chaque 
groupe (s'il y a un premier, pourquoi pas lui ? et s'il n'y en a pas, e'est que le groupe 
est vide). 

On part done d'une declaration de cle, comme ceci : 

<xsl :key name="groupesdeSurfacesParValeurs" 
match="attribute: :surface" 
use="." /> 

Ensuite, on veut recolter des surfaces ; on va done ecrire : 

//attribute: :surface 

cequi recolte toutes les surfaces. Un noeud attribute de ce node-set ne doit etre garde 
que s'il s'identifieau premier noeud attribute renvoye par : 

key( 'groupesdeSurfacesParValeurs' , la valeur textuelle du nosud teste) 

Or la valeur textuelle du noeud teste est tout simplement la valeur textuelle de "." , 
puisqu'on est en train d'etablir un predicat : 

key( 'groupesdeSurfacesParValeurs' , . ) 

Le premier noeud du node-set renvoye par cette expression est done : 

key( 'groupesdeSurfacesParValeurs' , . )[1] 
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Ce qui donne un predicat de la forme : 

//attribute: :surface[ 

. s'identifie a ( key( 'groupesdeSurfacesParValeurs' , .)[1] ) 

] 

On est done maintenant ramene a un probleme d' identification (ou de test d' identite), 
probleme que I'on sait resoudre (voir ci-dessus) ; nous choisissons ici la methode par 

appel de la fonction generate-id( ) : 

Creation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-id( ) = 
generate-id( 

key( 'groupesdeSurfacesParValeurs' , . )[1] 

) 

] 
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Les patterns de transformation, a I'inverse des patterns de programmation, constituent 
des buts en soi. Ceci ne veut pas dire qu'une feuille de style n'aura jamais d'autre but 
quecelui misen ceuvreau traversdu pattern, mais plutot qu' une feui I le de style qui ne 
mettrait en oeuvre qu'un de ces patterns pourrait tout de meme faire quelque chose de 
sense. 

Comme pour les patterns de programmation, il ne s'agit pas ici de constituer un catalo- 
gue exhaustif. 1 1 est meme probable que la mise en evidence de nouveaux patterns se fera 
plus pour des patterns de transformation que pour des patterns de programmation. 

Pattern n° 10 - Copie non conforme 

Motivation 

Nous avons donne beaucoup d'exemples (voir S<?mantique, page 325) de I' utilisation de 
I 'instruction xsi :copy, mais peut-etre avez vous pense qu'ils n'etaient pasforcementtres 
utiles dans la pratique. En effet, a quoi sert de recopier a I'identique un document X M L 
vers un autre ? 

En fait, cela n'estpassi inutile que cela, caravec xsi :copy, il est possible de regler fine- 
ment le moment ou la copie s'arrete pour laisser place a la variante. II est ainsi possible 
d'obtenir une copie d'un fragment XM L, qui n'est pas exactement identique a I 'original, 
mais legerement differente. 

Par ailleurs, si nous avons donne beaucoup d'exemples, c'etait pour illustrer les diffe- 
rents cas possibles de comportement de I 'instruction xsi :copy en fonction du type de 
nceud courant. M ais il est possible d'ecrire une copie generique, qui marchedans tous les 
cas. 
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Done, avant de voir une copie non conforme, voyons tout d'abord une copie conforme 
generique. II evident, par ailleurs, qu'une copie conforme se fait tres simplement avec 
xsi :copy-of ; mais pour evoluer vers une copie non conforme, il faut partir d'une copie 
conforme utilisant xsl:copyetnon paS xsl : copy -of. 

Ensuite nous verrons I'interet qu'il peuty avoir a obtenir un document presque identique 
a I'original, et comment realiser cela. 

Copie conforme generique 

Commencons par considerer la regie suivante : 

<xsl : tempi ate match="*"> 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl :templ ate> 

C'est une regie recursive, puisque el I e s'applique a tout element, et qu'elle sera done 
selectionnee pour traiter les nceuds rassembles en une nouvelle liste par <xsi :appiy- 

templ ates/>. 

Une des premieres choses dont il faut done s'inquieter, c'est de savoir si la recursion a 
des chances de s'arreter, ou si el I e est infinie. Clairement, la recursion s'arrete si la liste 
de nceuds constitute par <xsi :appiy-tempiates/> est vide. Cela peut-il se produire? 
Oui, puisque les nceuds en question sont les enfants directs du nceud courant. Si done le 
nceud courant est une feuille de I 'arbre XML, la recursion s'arrete. 

La regie montree ci dessus exprimedonc la definition recursive suivante : 

La recopie d'un element, c'est : 

la copie de cet element 

a laquelle on accroche : 

- la recopie du premier enfant 

- la recopie du deuxieme, 

- la recopie du dernier enfant, 

- ou rien s'il n'y a pas d'enfant. 

Ceci constitue done I 'idee de base pour realiser une copie conforme et en profondeur d'un 
element. M ais ce n'est pas suffisant, car I'element peut avoir des attributs, qui dans la regie 
ci-dessus, sont ignores. Comme en XM L, un attri but n'est pas un enfant, les attributs ne 
sont done pas pris en compte par cette regie. 

M ais il suffit d'y penser, et dedemander la recopie des attributs : 

La recopie d'un element, c'est : 

la copie de cet element 

a laquelle on accroche : 
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I- la recopie des attributs s'il y en a, 
- la recopie des enfants s'il y en a. 

M ais du coup, si I'on fait 5a, la regie est incomplete, car on y demande la recopie des 
attributs, alors qu'on definit la recopie d'element, mais pas eel le d'attri but. La encore, 
e'est tres simple de corriger : 

la recopie d'un element ou d'un attribut. e'est : 

la copie de cet element ou de cet attribut 
a laquelle on accroche : 

- la recopie des attributs s'il y en a, 

- la recopie des enfants s'il y en a. 

Si cette regie s'applique a un attribut, el le dit que la recopie d'un attribut, e'est la copie 
de cet attribut, suivie de la recopie de ses attributs ou de ses enfants. M ais un attribut n'a 
ni attribut ni enfant ; la recopie d'un attribut se resume done a la copie de cet attribut, ce 
qui mafoi sembleassez satisfaisant pour I 'esprit. 

Traduite en XSLT, cette regie devient : 

<xsl :template match="child: :*|attribute: :*"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl :apply-templates select="child: :*"/> 
</xsl :copy> 
</xsl :templ ate> 

Notonsquechiid: : * est la forme longuede "*", etque<xsi :appiy-tempiates seiect= 
"child: :*"/> selectionne moins de types de nceuds que <xsi :appiy-tempiates/>. En 
effet, ce sont tous les enfants du nceud courant qui sont selectionnes par instruction 
xsi :appiy-tempiates, pas seulement ceux qui sont des elements, maisaussi lestextes, 
les commentaires et les processing-instructions. 

M ais la facon dont la regie est ec rite, ci-dessus, renforce le paralleleavec la definition en 
langue naturelle telle qu'on I'a etablie. 



Note 

II faut remarquer ici que I'ordre relatif des deux instructions xsi :appiy-tempiates est important, car il fautse 
rappeler ici qu'il est interdit d'accrocher un attribut a un nceud si on a deja commence a accrocher des enfants 
(voir Regie XSLT typique, page 291). 

Est-on arrive a la forme definitive de cette regie? Pas tout a fait. Pour I' instant nous 
traitons les elements et les attributs, mais il y a d'autres types de nceuds possibles : le 

type text, le type namespace, le type comment, le type processing-instruction, et 

le type root. 

Nous avonsvu (voir Copie d'un n«ud detype element, page 326 et Copie d'un n^ud de 
type namespace, page 338) qu'un noeud de type namespace est copie automatiquement 
par I'instruction <xsi:copy> appliquee a un element, il n'est done pas necessaire de 
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s'occuper explicitement des domaines nominaux. De meme (voir Copie du na?ud de type 
root, page 339), la racine root de I'arbre XM L du resultat est creee automatiquement, 
sansqu'il y aitbesoin des'en occuper. Restentlestextes, les commentai reset I es proces- 
sing-instructions, Leur point commun, c'est qu'ils sont chacun necessairement enfant 
d'un element. 

Si le noeud courant est un element, instruction <xsi :appiy-tempiates seiect= 
"child: :*"/> ne selectionne que des elements (voir Le determinant est une *, page 55). 

M aiS I 'instruction <xsl :appiy-templates sel ect="chi 1 d : :node( )"/> (OU pi US Simple- 

ment <xsi :appiy-tempiates"/>), selectionne tous les nceuds qui peuvent etre des 
enfants du noeud courant : c'est exactement cela qu'il nous faut, puisque seront compris 
les commentaires, les textes, et les processing-instructions. Mais si on les selectionne, 
encore faut-il que la regie les accepte en entree ; il faut done aussi modifier en conse- 
quence I'attribut match : 

<xsl :template match="child: :node( ) |attribute: :*"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl :apply-templates select="child: :node()"/> 
</xsl :copy> 
</xsl :templ ate> 

Cette regie est maintenant correcte, mais on peut la simplifier legerement : 

<xsl :template match="child: :node( ) |attribute: :*"> 
<xsl :copy> 

<xsl :apply-templates select="child: :node() | attribute: :*"/> 
</xsl :copy> 
</xsl :templ ate> 

Note 

On peut toutefois s'interrogersur le bien-fonde de cette simplification. En effet on a maintenant I'union de deux 
node-sets, ce qui donne un nouveau node-set, dans lequel sont melanges des attributs, des elements, des 
textes, etc. Or un node-set n'est pas ordonne ; on peut done craindre que les nceuds ne soient pas traites dans 
le bon ordre (i.e. les attributs avantles elements). En fait, il n'y pas de probleme ici, carxsi :appiy-tempiates 
traite les nceuds du node-set renvoye par le select dans I'ordrede lecture du document. Or I'ordre de lecture du 
document est parfaitement specifie, (voir Representation graphique, page 50), et stipule que pour un element 
donne, les attributs viennent avant les enfants. Done ici, nous retombons sur nos pieds, et nous sommes surs 
que les attributs (s'il y en a) seront traites avantles autres nceuds. 

La derniere petite touche que I'on peut apporter a cette regie, c'est de la rendre plus sure 
a utiliser dans des contextes differents : 

<xsl :template match="child: :node( ) [attribute: :*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" mode="copie"/> 
<xsl :apply-templates select="child: :node()" mode="copie"/> 
</xsl :copy> 
</xsl :templ ate> 
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Cettefois, on a une regie qui n'estactiveequesi on precise le mode« copie » ; el I e peut 
done coexister pacifiquement avec d'autres regies ayant un motif similaire, mais des 
transformations completement differentes. 

M ais ii peut aussi arriver que I'on ait besoin que la copie soit conforme par defaut, sauf 
pour certains elements que I'on equipe d'une regie specifique. Dans ce cas, la copie ne 
doit pas etre lancee autoritairement sur tel element particulier, el I e doit se lancer toute 
seulequand il n'y a aucune autre regie eligible. 

Un exemple de cette idee se trouve mis en ceuvre aux sections Pattern n° 8 - Utilisation 
d'une structure de donne'es auxilaire, page 422 et Pattern n°18 - Localisation d'une 
application, page 533. 

Cela peuttressimplementsefaireainsi : 

<xsl :template match="child: :node() |attribute: :*" priority="-10"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl :apply-templates select="child: :node( )" /> 
</xsl :copy> 
</xsl : tempi ate> 

En affectant une priori te extremement faible a cette regie, on est sflr qu'elle ne sera selec- 
tionnee que si le processeur XSLT n'a vraiment rien d'autre a se mettre sous la dent. 

Terminons par une remarque concernant le degre de conformite d'une copie conforme : 
le point devue est ici celui du parseur XM L, non celui de I 'ceil humain. En particulier, il 
est impossible a priori de discerner deux documents XML qui ne different que de la 
facon dont sontecrits les attributs (avec des gui I lemets ou des apostrophes), ou les textes 
contenant des caracteres interdits comme ■<• ou "&" (avec des <! [cdata[<]]> ou avec 
des &it ; ). 

Copie presque conforme 

Nous partons ici d'un document XM L contenant du X HTM L genere par Docbook. 

Note 

Docbook est une DTD associee a des feuilles de style XSLT pour rediger des articles, des livres, etplus genera- 
lementde la documentation. Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook.org). 

doc.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=UTF-16"/> 
<title>Generation de la documentation avec Docbook</titl e> 
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< 1 ink rel="stylesheet" href="..css" type="text/css"/> 
<meta name="generator" content="DocBook XSL Stylesheets V0"/> 
</head> 

<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" al ink="#0000FF"> 
<div class="article"> <div class="titlepage"> 
<div> <hl class="title"> 

<a name="dOel"X/a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xml ns="http:/ /www. w3.org/TR/xhtml 1/transitional " 

cl ass="fi 1 ename">C: \DocBook\RunDocBook\extens ions \ verbatim. j a va</tt>, 

qui a finalement 1 'allure suivante: 

<table xml ns="http: //www. w3.org/TR/xhtml 1/transitional " 

border="l" bgcol or="#EOEOEO"> 
<caption al ign=" right" class="l istingTitle">verbatim. java</caption> 
<tr><td> 

<pre class="programlisting"> 
// ici listing de programme Java</pre> 
</td></tr> 
</table> 
</p> 

<!-- ... suite du fichier sans importance ... --> 
</div> 
</body> 
</html> 

Le vrai probleme que nous nous posons ici, c'est de modifier le listing qui se trouve 
entre les balises <pre> . . . </pre> en remplacant les tabulations initiales de chaque 
ligne de code par des series de quatre espaces. Ceci parce que les navigateurs 
comptent en general huit espaces par tabulation, ce qui est beaucoup trop pour 
certains listings. 

Traduit en terme de copie non conforme, cela veut dire que nous cherchons a faire une copie 
conforme du document, a ceci pres que les elements <pre> seront legerement differents dans 
leur contenu. 

Cependant, ce probleme est curieusement difficile. 

Non pas a cause de la copie en elle-meme, qui repose sur ce qu'on vient de voir, ni a 
cause du remplacementde tabulations par des espaces, qui est simple a real iser. 

Ce probleme est difficile parce que I'element <pre> est un descendant de I'element 
<tabie>, qui declare un domaine nominal par defaut. Cette difficult^ est done complete- 
ment hors-sujet dans cette section, mais pour illustrer malgre tout cette notion de copie 
non conforme, nous allons supposer que nous voulons expurger la partie <head> pour ne 
garder que la balise <tuie>, tout le reste etant conserve intact. 
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copie.xsl 

<?xml version='1.0' encodings' ISO-8859-1" ?> 
<xsl :styl esheet xml ns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version='1.0'> 



<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1' /> 



<xsl : tempi ate match="/"> 

<html> 

<xsl :apply-templates/> 

</html> 
</xsl :templ ate> 

<xsl :template match="/html /head"> 

<head> 

<xsl :apply-templates/> 

</head> 
</xsl :templ ate> 

<xsl :template match="/html /head/*"> 
</xsl :templ ate> 



<xsl : tempi ate match="/html /head/titl e" priority="2"> 

<xsl :apply-templates select^"." mode="copie"/> 
</xsl :templ ate> 

<xsl : tempi ate match="body"> 

<xsl :apply-templates select="." mode="copie"/> 
</xsl :templ ate> 

<xsl :template match="child: :node( ) | attribute::*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="@*" mode="copie"/> 
<xsl :apply-templates sel ect="node( ) " mode="copie" /> 
</xsl :copy> 
</xsl :templ ate> 



</xsl :stylesheet> 

La copie est lancee sur deux elements : <tme> et <body> ; le reste est reconstruit a 
la main, eteventuellement modifie. Ici la non conformite de la copie est due a la regie 
<xsi template match="/htmi /head/*"> ; cette regie annule tous I es elements 
enfants de <head>, sauf <tnie>, qui beneficie d'une regie a part. On remarquera 
d'ailleurs la priorite 2 imposee a cette regie a part, pour eviter I'ambiguite avec la 
regie d'annulation. 

Leresultatobtenu estbien celui qu'on attendait. 
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Pattern n° 11- Detection d'un element avec domaine nominal 
par defaut 

Motivation 

La motivation est tres simple: on veut ecrire une transformation XSLT (peu importe 
laquelle) qui necessi ted 'ecrire une certaine regie pour un certain element. En principe, il 
n'y a rien de plus facile a fai re, il suffit d'ecrire par exemple : 

<xsl : tempi ate match="truc"> 
</xsl :templ ate> 

L e probleme qui peut surveni r est que dans le document source X M L , I 'element <truc> 
soit associe a un domaine nominal par defaut. 

La regie ci-dessus n'est alors jamais activee, carle motif utilise, true, concordeavec tout 
element <truc> sans domaine nominal, mais pas avec un element possedant un domaine 
nominal, qu'il soitexpliciteou par defaut. 

Une solution decontournementpeuteventuellementetremiseen place, commececi : 

<xsl : tempi ate match="*[ local -name( ) = 'true' ]"> 
</xsl :templ ate> 

Cela fonctionne, car "*" ramasse tout ce qui se trouve sur I'axe child: :, et ensuite on 
filtre pour ne garder que les elements dont le nom estegal a la chalne 'true' . 

M ais ce n'est pas extraordinaire comme style, car cette regie sera selectionnee sur tout 
element, puis presque toujours rejetee a cause du predicat. Par ailleurs, on ne fait que 
contourner le probleme, alors qu'on pourrait le resoudre. 

Solution 

La solution passe evidemment par I'ecriture d'un motif qui Concorde avec un element 
<truc>, dans un certain domaine nominal par defaut. 

Une chose est certaine, e'estque: 

<xsl : tempi ate match="truc"> 

concordeavec tout element <tmc> qui n'est dans aucun domaine nominal. 

Si I'on veut ecrire un motif qui concorde avec un element <tmc> dans un certain 
domaine nominal, il fautabsolument ecrire quelque chose du genre: 

<xsl : tempi ate match="xx:truc"> 

ou xx represente un prefixe (ou abreviation) d'un certain domaine nominal. 

Mais e'est precisement la que la difficult^ surgit: si on ajoute un prefixe, le domaine 
nominal n'est plus « par defaut », penserez vous. Certes, mais ou? Parlons-nous d'un 
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domaine nominal « par defaut» dans le programme XSLT, ou « par defaut» dans le 
document source XM L ? 

Un domaine nominal, cela reste un domaine nominal, qu'il soit par defaut ou non. C'est 

done quel que Chose dU genre : http://www.machinchose.fr/bidule. 

Si le document source se presente comme ceci : 

<machin xmlns=" http://www.machinchose.fr/bidule"> 
<truc> 

</truc> 
</machin> 

I'element <truc> a un domaine nominal par defaut. 
Si le document source se presente comme cela : 

<machin xmlns:xx="http:/ /www. machinchose.fr/bidule"> 
<xx:truc> 

</xx:truc> 
</machin> 

I'element <truc> a un domaine nominal explicite. 

Le point un peu subtil, mais ici essentiel pour obtenir la solution, c'est que dans les deux 
cas, le domaine nominal peut tr<?s bien etre le mime, la seule difference r<?sidant dans la 
facon de le dire. 

Done une regie telle que : 

<xsl :template match="xx:truc"> 

n'est pas une regie concordant avec 

tout element "true" dont le prefixe est "xx" 

mais avec 

tout element "true" dont le domaine nominal est 
http://www.machinchose.fr/bidul e 

en supposant que xx soit I'abreviation dece domaine nominal. 

La solution, pastres evidente, il faut bien I e reconnaitre, est done de declarer un domaine 
nominal explicite dans le programme XSLT, comme ceci : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 



xmlns:xx=" http://www.mach inchose.fr/bidule" 
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version='1.0'> 
<!-- etc --> 

puis d'ecrire la regie en faisant mention du domaine nominal requis : 

<xsl :templ ate match="xx:truc"> 
</xsl :templ ate> 

L e document source XML est suppose etre de la forme suivante : 

<machin xmlns=" http://www.machinchose.fr/bidule"> 
<truc> 

</truc> 
</machin> 

Le motif de la regie ci-dessus Concorde avec tout nceud <truc> dans le domaine nominal 
http://www.machinchose.fr/bidule ; or c'est precisement le cas de I'element <truc> du 
fragment XML ci-dessus. Done la regie s'appliquera bien a I'element <truc> en ques- 
tion. 



Note 

Cette fagon de resoudre le probleme esttellementpeu intuitivement evidente, qu'elle a fait Tobjet d'une requete 
officielle d'amelioration pour la version XSLT 2.0. On pourra consulter, dans http://www.w3.org/TR/xslt20req, la 
section intitulee « 2.1 Must Allow Matching on Default Namespace Without Explicit Prefix ». 



Exemple 

Nous allons pouvoir revenir au probleme de la copie non conforme dont il etait question 
a la section Copie presque conforme, page 447, et arriver cette fois a une solution satis- 
faisante au probleme pose. Rappelons quil s'agit de modifier legerement le document 
XHTM L produit par Docbook, en intervenant uniquement dans les balises <pre ciass= 
"program! isting">, afin de supprimer les tabulations initiales de chaque ligne, en les 
remplacant par des series de quatre espaces. 

Voici toutd'abord un extraitdu document XHTM L a transformer : 

doc .html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=UTF-16"/> 
<title>Generation de la documentation avec Docbook</titl e> 
< 1 ink rel="stylesheet" href="..css" type="text/css"/> 
<meta name="generator" content="DocBook XSL Stylesheets V0"/> 
</head> 

<body bgcolor="white" text="black" 1 ink="#OOOOFF" vl ink="#840084" 
alink="#O00OFF"> 
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<div class="article"> <div class="titlepage"> 
<div> <hl class="title"> 

<a name="dOel"X/a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<div class="sectl"> <div class="titlepage"> 

<div> <h2 class="title" style="clear: both"> 

<a name="d0e38"X/a>l . Documentation avec docbook 
</h2> 
</div> 
</div> 

<div cl ass="sect2"> <div class="titlepage"> 
<div><h3 class="title"> 



</div> 
</div> 

<div cl ass="sect3"> <div class="titlepage"> 
<div> <h4 class="title"> 

<a name="d0e231"X/a>1.2.6. puratim. class 
</h4> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xml ns=" http://www.w3.org/TR/xhtml 1 /transitional " 
cl ass="f i 1 ename">C: . java</tt> , 

qui a finalement 1 'allure suivante: 



<tabl e xml ns="http: //www. w3.org/TR/xhtml 1/ transitional " 

border="l" bgcol or="#EOEOEO"> 
<caption align=" right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 

<pre class="programlisting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 
try { 

Fi 1 elnputStream fis = new FilelnputStreamt arg[0] ); 
InputStreamReader isr = new InputStreamReadert fis, "UTF-16" ); 
BufferedReader in = new BufferedReader( isr ); 



Chapitre 9 




<a name="d0e46"> 

</a>1.2. Description des principaux fichiers utiles 
</h3> 



line = in . readLinet ) ; // la 2' ligne n'est pas recopiee 
// (c'est la reference au graphe) 



for(;;){ 
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line = in. readl_ine( ) ; 

if ( line == null ) break; 

pw.println( line ); 

} 

} 

} 

}</pre> 

</td> 

</tr> 

</table> 

</p> 

<p>A priori le service "Securite des reseaux" est au courant de ce probleme, 

qui devrait done etre resolu dans les jours qui viennent. 

Lorsque ce sera le cas, on pourra supprimer ce fichier 

<tt xmlns=" http://www.w3.org/TR/xhtmll /transitional " 

cl ass="f ilename">puratim.cl ass</tt> 

</p> 

</div> 
</div> 
</div> 
</div> 
</body> 
</html> 

On voit que le probleme de la detection d'un element dans un domaine nominal par 
defaut va se poser ici, puisque I'element <pre . . .> fait partie de la descendance de 
<tabie ...>, qui declare le domaine nominal par defaut http://www.w3.org/TR/ 

xhtml 1/transi ti onal . 

On va done mettre en ceuvre la solution indiquee plus haut; cela consiste d'abord a 
declarer un domaine nominal identique, identi fie par une abreviation quelconque qui 
servira de prefixe. On ecrira done : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xml ns :xsl="http: //www. w3.org/1999/XSL/Transform" 

xml ns :dns="http: //www. w3.org/TR/xhtml 1/transi ti onal " 

version='1.0'> 

<!-- etc --> 

Ensuite, puisque I'on veut tout copier a I'identique, sauf precisement les elements <pre 
ci ass="programi i sting">, il va falloir ecrire une regie speciale pour ces elements : 

<xsl :templ ate match="dns :pre"> 
<pre class="programlisting"> 

<xsl : cal 1 -tempi ate name=" repl ace_f i rst_tabs_on_al 1_1 i nes"> 
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<xsl :with-param name="codeSource" select="." /> 
</xsl : call -tempi ate> 
</pre> 
</xsl : tempi ate> 

La regie ci-dessus semble correcte. Et pourtant ... Nous ne sommes pas au bout de nos 
peines avec les domaines nominaux. Telle qu'indiquee, la regie est correcte, du moins 
dans I'expression du motif : c'est tout I'objet de la discussion de la section precedente. 
Le corps de la regie, par contre, va poser a nouveau probleme; voici cequel'on va obtenir 
lorsquelemodelede transformation decette regie sera instancie : 

<pre 

xmlns="" 

xmlns:dns=" http://www.w3.org/TR/xhtmll/transitional " 

cl as s=" prog rami isting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 

}</pre> 

Dans le document resultatgenere, I 'element <pre . . .> est defini avec un domaine nomi- 
nal par defaut nul (xmins="") ; cela signifie que cet element ne fait parti e d'aucun 
domaine nominal par defaut. 

On a de plus une definition du domaine nominal http://www.w3.org/TR/xhtmii/tran- 
sitionai, deja declare dans I'element <tabie . . .>, mais comme domaine nominal par 
defaut, alors qu'ici, il est associe au prefixe dns. Pourquoi pas? Apres tout, ce qui 
compte, c'est que I'element soit associe au bon domaine nominal ; que ce soit par le 
truchementd'un domaine nominal par defaut ou explicite, peu importe. 

Oui, mais malheureusement, I'element <pre> n'a pas de prefixe. Et comme il ne fait 
desormais plus partie d'aucun domaine nominal par defaut, <pre> n'est done associe a 
aucun domaine nominal. En cela, la copie que nous avons realisee est trap infidele, car 
nous ne voulions pas modifier quoi que ce soit aux domaines nominaux, mais seulement 
faire sauter les tabulations. 

Cette fois, cependant, le probleme n'est pas difficile a identifier et a corriger ; c'est la 
regie que nous avons ecrite qui est i ncorrecte, car el I e uti I i se I 'element I i tteral sans I e pre- 
fixe dns. Or, dans le programme XSLT, il n'y a pas de domaine nominal par defaut ; 
ainsi, un element I i tteral, comme <pre>, qui apparaft sans prefixe, est un element sans 
domaine nominal. Le processeur XSLT a done genere une declaration d'annulation de 
domaine nominal (sous la forme xmins="") afin d'obeir a nos ordres. 

Le plus dur est peut-etre de real i ser qu'on a effectivement donne cet ordre. 

Ayant vu cela, la correction est immediate : 

<xsl :template match="dns:pre"> 

<dns :pre cl ass="programl isting"> 

<xsl : cal 1 -tempi ate name="repl ace_f i rst_tabs_on_al 1_1 i nes"> 
<xsl :with-param name="codeSource" select="." /> 
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</xsl :call-template> 
</dns :pre> 
</xsl :templ ate> 

Avec cette regie corri gee, on obtiendra ceci : 

<dns:pre 

xmlns:dns=" http://www.w3.org/TR/xhtmll /transitional " 
cl ass="programl i sti ng "> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 

}</dns:pre> 

Cette fois, c'est bon, le document resultat est identique au document d'origine du point 
de vue du traitement des domaines nominaux. La seule difference, c'est que dans le 
document d'origine, I 'element <pre> est associe a un domaine nominal par defaut, alors 
que dans le document resultat, il est associe a un domaine nominal explicite. Mais 
comme dans les deux cas, il s'agit du meme domaine nominal, les deux documents sont 
equival ents du poi nt de vue XML. 

Le programme XSLT est celui-ci (les model es nommes real isant la suppression effective 
des tabulations ne sont pas montres, car ils sont hors-sujet pour ce qui nous occupe 
actuellement) : 

tabsToSpaces.xsl 

<?xml version='1.0'?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xml ns:dns=" http://www.w3.org/TR/xhtml 1 /transitional " 
version='1.0'> 



<xsl:output method='html ' encoding='IS0-8859-l' /> 
<xsl : tempi ate name="repl ace_fi rst_tabs_on_al 1_1 ines"> 
</xsl : tempi ate> 



<xsl : tempi ate match="/"> 

<xsl :apply-templates mode="copie"/> 
</xsl :template> 

<xsl : tempi ate match="dns :pre" mode="copie"> 

<xsl :comment>Dans pre[@cl ass='programl i sting] '</xsl :comment> 
<dns :pre cl ass="programl isting"> 

<xsl : cal 1 -tempi ate name=" repl ace_f i rst_tabs_on_al 1_1 i nes"> 

<xsl :with-param name="codeSource" select="." /> 
</xsl : cal 1 -template> 
</dns:pre> 
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</xsl :templ ate> 

<xsl :template match="child: :node( ) | attribute::*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="@*" mode="copie"/> 
<xsl :apply-templates sel ect="node( ) " mode="copie" /> 
</xsl :copy> 
</xsl :templ ate> 

</xsl :stylesheet> 

Et voici maintenant le resultat obtenu (la presentation a ete remaniee pour les besoins de 
la miseen page) : 

docSansTabs.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<meta http-equiv="Content-Type" content="text/html ; charset=UTF-16"> 
<title>Génération de la documentation avec Docbook</title> 
< 1 ink rel="stylesheet" href="..css" type="text/css"> 
<meta name="generator" content="DocBook XSL Stylesheets V0"> 
</head> 

<body bgcolor="white" text="black" 1 ink="#0000FF" vl ink="#840084" 
alink="#0000FF"> 
<div class="article"> 
<div class="titlepage"> 
<div> 

<hl class="title"> 
<a name="dOel"X/a> 

Génération de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<div cl ass="sectl"> 

<div cl ass="titl epage"> 
<div> 

<h2 class="title" style="clear: both"> 
<a name="d0e38"X/a>l . Documentation avec docbook 
</h2> 
</div> 
</div> 

<div cl ass="sect2"> 

<div cl ass="titl epage"> 
<div> 

<h3 cl ass="titl e"> 
<a name="d0e46"X/a> 

1.2. Description des principaux fichiers utiles 
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</h3> 
</div> 
</div> 

<div cl ass="sect3"> 

<div class="titlepage"> 
<div> 

<h4 cl ass="titl e"> 

<a name="d0e231"X/a>1.2.6. puratim. class 
</h4> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xmlns=" http://www.w3.org/TR/xhtmll/transitional " 

cl ass="f il ename">C: . java</tt>. 

qui a finalement 1 'allure suivante: 

<table xmlns=" http://www.w3.org/TR/xhtmll /transitional " 
border="l" bgcolor="#EOEOEO"> 
<caption al ign=" right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 

<! --Dans pre[@class='programli sting] '--> 
<dns:pre 

xml ns:dns=" http://www.w3.org/TR/xhtml 1/transi tional " 
cl ass="programl isting"> 
import java.io.*; 
public class puratim { 
public static void main( String arg[] ) { 
try { 

Fi 1 elnputStream fis = new Fi 1 elnputStreamt arg[0] ); 
InputStreamReader isr = new InputStreamReader( fis, "UTF-16" ); 
BufferedReader in = new BufferedReader( isr ); 

line = in.readLine( ) ; // la 2° ligne n'est pas recopiée 

// (c'est la référence au graphe) 

for(;;){ 

line = in.readLineO; 

if ( line == null ) break; 

pw.println( line ); 



} 

} 

</dns :pre> 
</td> 
</tr> 
</table> 
</p> 



Pattern n 12- References croisees inter fichiers H 

i ii i ii i i 'i M 

<p>A priori le service "Sécurité des réseaux" 
est au courant de ce problème, qui devrait done être 
résol u dans les jours qui viennent. Lorsque ce sera le cas, 
on pourra supprimer ce fichier 

<tt xmlns="http: //www. w3.org/TR/xhtml 1/transitional " 
cl ass="filename">puratim.cl ass</tt> 

</p> 

</div> 
</div> 
</div> 
</div> 
</body> 
</html> 

Si I'on compare maintenant I e document original etcelui obtenu, on constate des diffe- 
rences de presentation, et d'encodage des caracteres non A scii, mais aucune difference de 
structure X M L . On a les meme elements, avec les memes attributs et les memes domai- 
nes nominaux. La suppression des tabulations n'est pas visible ici, mais ce n'est pas vrai- 
ment le sujet qui nous a donne du travail. On pourra toutefois trouver une discussion 
specifique sur ce sujet a la section Exemple, page 402. 

Finalement, on voit que ce n'est pas forcement si evident que ca de real iser une copie 
presque conforme d'un document utilisant les domaines nominaux. M ais les solutions a 
mettre en oeuvre, pour ces problemes de domaines nominaux, sont assez generiques ; 
el les sont done parfaitement reuti I isabl es dans d'autres circonstances, sans rapport avec 
des copies presque conformes. 

Pattern n° 12- References croisees inter fichiers 

Motivation 

L es problemes de references croisees sont tres frequents en X SLT ; ce sont des problemes 
oil, pour traiter une information A, il faut en deduire une information B, puis rechercher 
cette information B, eventuellement dans un autre document, qui donne acces a une 
information C. On peut alors presenter cote a cote les informations A etc. 

S'il y a beaucoup d'informations A a traiter, le point critique est la recherche de B dans 
tout un document, car cette recherche est multipliee par le nombre de A a traiter. 

Une solution efficace consiste alors a index er les informations A par les informations B, 

en Utilisant le COUple instruction xsl :key/fonction key(). 

Nous allons montrer eel a sur un exemple mettant en oeuvre deux fichiers source XM L. 

Pour cela nous reprenons I 'exemple que nous avions vu a la section Exemple, 
page 307. Nous avions un fichier codesPiages.xmi contenant des informations sur des 
codes utilises par ailleurs : 
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codes PI ages .xml 

<?xml version="1.0" 
<codes> 

<artistes> 

<artiste id= 

<artiste id= 

<artiste id= 

<artiste id= 

<artiste id= 

<artiste id= 

<artiste id= 
</arti stes> 



encoding="IS0-8859-l"?> 



"cplu" name="Christine Plubeau"/> 

"nspt" name="Noel 1 e Spieth"/> 

"eblq" name="Eric Bellocq"/> 

"fmrt" name="Frederic Martin"/> 

"oded" name="Odile Edouard"/> 

"fech" name=" Freddy Eichelberger"/> 

"dsmp" name="David Simpson"/> 



<instruments> 

<instrument i d="vdg" 

instrument id="clv" 

instrument id="thb" 

<instrument id="vll" 

instrument id="v!2" 

instrument id="org" 

instrument id="vlc" 

</instruments> 



name="Viole de gambe"/> 
name="Clavecin"/> 
name="Theorbe"/> 
name="Violon baroque"/> 
name="Violon baroque"/> 
name="Orgue posi ti f " /> 
name="Violoncelle baroque"/> 



</codes> 



Par ailleurs, nousavionsun fichierX M L contenantdes descriptions de plages de CD, mis 
en pi ace dans ce memeexemple, et modi fie par la suite pour i 1 1 ustrer leprincipedenume- 
rotation des nceuds (voir Exemple, page 350). 



PlagesCD.xml 

<?xml version= 
<pl ages> 



'1.0" encoding="IS0-8859-l"?> 



<plage No="l" vdg="cplu" clv="nspt" 

thb="eblq" vll="frart" 

vl2="oded" org="fech"> Grave </plage> 

<plage No="2" thb="eblq" 

clv="nspt" vl l="fmrt" 

vl2="oded" vl c="dsmp"> Presto / Prestissimo </plage> 

<plage No="3" vdg="cplu" clv="nspt" 

thb="eblq" vll="fmrt" 
vl2="oded"> Adagio </plage> 



<plage No="4" thb="eblq" vdg="cplu 
clv="nspt" vll="fmrt 
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vl c="dsmp" 

org="fech"> Presto Recit de basse </plage> 

</pl ages> 

Ce fichier indique, pour chaque plage, la distribution sous forme d'attributs dont les 
noms sont des codes d'instruments, et les valeurs sont des codes d'artistes. Tous ces 
codes ont leur traduction en clair dans le fichier codes pi ages. xmi. II s'agit maintenant 
d'ecrire une transformation XSLT qui permette d'obtenir le fichier suivant (qui, mis en 
forme, pourrait figurer dans la pochette du disque, puisqu'il donne pour chaque artiste, 
les numeros de plages ou il intervient, et I'instrument dont il joue) : 

Resultat attendu 



Christine Plubeau 
13 4 Viole de gambe 



Noelle Spieth 
12 3 4 Clavecin 



Eric Bellocq 
12 3 4 Theorbe 



Frederic Martin 

12 3 4 Violon baroque 



Odile Edouard 

12 3 Violon baroque 



Freddy Eichelberger 
1 4 Orgue positif 



David Simpson 

2 4 Violoncelle baroque 

Puisque I'on veut un fichier ou les informations soient classees artiste par artiste, il semble 
logique de considerer que le fichier codesPi ages .xmi sera le fichier principal, et I 'autre le 
fichier secondaire. Le cheminement peut alors se faire comme ceci : 

1) Partantd'un <artiste>, on a son id (par exemplecplu) etson nom (Christine Plubeau). 

2) Connaissant I'id cplu on va rechercher dans le fichier piagesCD.xmi toutes les 
<pi age> qui ont un attri but dont la valeur est cplu, ce qui permet d'afficher les numeros 
de plages. 

2) Puis ayant I'une de ces plages, il faut noter le nom de I'attribut dont la valeur 
correspond a la valeur cherchee (cplu dans I'exemple), ce qui nous donne le code 
de I'instrument joue (vdg, en I'occurrence). 

2) Enfin, ayant ce code, on revient dans I e document source principal, ou I'on recherche un 
i nstrument dont le code correspond, et i I n'y a pi us qu'a afficher le nom de cet i nstrument. 
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Realisation 

La premiere chose a fai re estde mettre en place une table dissociation qui va donner des 
<piage>, connaissant des id d'artistes. 

Or, dans le fichier piagesCD.xmi, les id d'artistes ne sont pas references par des attributs 
dont le nom est fixe ; il suffit qu'on ajoute un nouvel instrument, pour que cela donne un 
nouveau nom d'attri but, dont la valeur est un id d'artiste. La cle sera done declaree ainsi : 

|<xsl :key name="PlagesParCodesArtistes" 
match="pl age" use="attribute: :*" /> 

Comme I'attribut use est une expression renvoyant un node-set, chaque valeur textuelle 
de chaque nceud de ce node-set va jouer le role de valeur de cle ; une fois construite, la 
table va done avoir I 'al lure representee a la figure 9-1. 




Figure 9-1 

Plages par codes artistes 
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De meme, il va nous f al loir une cle pour avoir un <instrument> connaissant son id : 

|<xsl :key name="InstrumentsParCodesInstruments" 
match="instrument" use="attribute: :id" /> 



Note 

On pourrait ici utiliser la fonction id(), qui renvoie I'element dont I'identifiant est egal a une valeur donnee. 
Neanmoins, on ne le fait pas, car la manipulation d'identifiant est plus lourde :il faut declarer I'attributcorrespon- 
dantdu type predefini ID, ce qui de fait, oblige aequiperle fichierXML d'une DTD, Une cle apporte ici beaucoup 
plus de souplesse, en nous affranchissantcompletementde I'obligation d'une DTD. 



Ceci etant, on peutcommencer a coder la transformation. L e but etantde I isterdes artistes, 
on va done partir du fichier codesPiages.xmi, ettraiter les elements <artiste> : 

<xsl :template match="artiste"> 
<xsl :template match="artiste"> 

<xsl :cal 1 -tempi ate name="instancier-NomArtiste"> 

<xsl :with-param name="nomArtiste" select="@nom"/> 
</xsl : call -tempi ate> 

<xsl :cal 1 -tempi ate name="instancier-NosPl agesAvecCetArtiste"> 

<xsl :with-param name="codeArti ste" select="@id"/> 
</xsl : cal 1 -tempi ate> 

<xsl :cal 1 -tempi ate name="instancier-NomInstnjmentDeCetArtiste"> 

<xsl :with-param name="codeArtiste" select="@id"/> 
</xsl :call-template> 

</xsl :templ ate> 

</xsl :templ ate> 

1 1 s'agit maintenant de determiner les trois model es nommes. 

Instanciation du nom de I'artiste 

II n'y a pas de difficulty particul iere ici : 

<xsl :template name="instancier-NomArtiste"> 
<xsl :param name="nomArtiste"/> 



<xsl :value-of sel ect="$nomArti ste"/> 
<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl :templ ate> 

Instanciation des Nos de plages 

II faut maintenant construire la table associee a la cle piagesParCodesArtistes, 
construction qui doitsefaireen explorantle fichier XM L auxiliaire piagesCD.xmi. C'est 
la fonction keyO qui realise cette tache, et on sait que I'arbre explore est celui qui 
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contient le nceud contexte de devaluation de I 'expression contenant I'appel. Pour explo- 
rer I'arbre XM L du document contenu dans PiagesCD.xmi, il faut done placer le nceud 
contexte de cet appel quel que part dans cet arbre. La racine n'etant pas un plus mauvais 
endroitqu'un autre, on peutdonc obtenir I'effet desire en ecrivant : 

<xsl : tempi ate name="instancier-NosPl agesAvecCetArtiste"> 
<xsl :param name="codeArti ste"/> 

<xsl :for-each select=" document ( ' PI agesCD.xml ' ) "> 

<!-- 

ici le nffiud contexte est la racine de I'arbre XML du document 
contenu dans PiagesCD.xmi, car la fonction documentO renvoie 
un node-set ne contenant que la racine du document demande. 

--> 

</xsl :for-each> 
</xsl :templ ate> 

En mettant I'appel a key ( "PlagesParCodesArtistes", ScodeArtiste ) a la place du 

commentaireci-dessus, on va done construire une table d'apres le bon fichier XML. 

M ais cet appel est susceptible de renvoyer plusieurs nceuds, puisque un meme artiste peut 
intervenir pour plusieurs plages du CD. II faut done explorer un par un les nceuds ren- 
voyes, avec un xsi :for-each , dans lequel le nceud contexte est a nouveau change, et 
passe tour a tour sur chaque <pi age> renvoyee : 

<xsl :template name="instancier-NosPlagesAvecCetArtiste"> 
<xsl:param name="codeArti ste"/> 

<xsl :for-each select=" document ( ' PI agesCD.xml ' ) "> 

<xsl :for-each select='key( "PlagesParCodesArtistes", 

$codeArtiste )'> 
<xsl :value-of select=". /attribute: :No"/> 
<xsl:text> </xsl:text> 
</xsl :for-each> 
</xsl :for-each> 

</xsl :template> 

Instanciation des noms d'instruments 

Si I'on connait le code instrument, un appel a 

key( "InstrumentsParCodesInstruments" , $codeInstrument ) 

renvoie l'<instrument> cherche. Ici, I'arbre XML a explorer est celui du document 
source principal, done en principe, le nceud contexte, quel qu'il soit, est dans cet arbre: 
inutile ici d'immerger I'appel a keyo dans un xsi:for-each pour placer le nceud 
contexte dans le bon arbre X M L. Ayant l'<instmment> cherche, il n'y a plus qu'a prendre 
lavaleurdeson attri but nom . 
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<xsl :template name="instancier-NoinInstruinentDeCetArtiste"> 
<xsl :param name="codeArtiste"/> 
<xsl :variable name="codeInstrument"> 

<xsl :cal 1 - tempi ate name="instancier- code Instrument'^ 

<xsl :with-param name="idArtiste" select="$codeArtiste"/> 
</xsl :cal 1 -tempi ate> 
</xsl :variable> 



<xsl :val ue-of select='key( "InstrumentsParCodesInstruments" , 

$codeInstrument )/attribute: mom' /> 



<xsl :cal 1 -tempi ate name="instancier-sautl_igne"/> 
</xsl :templ ate> 

L e probleme est done d'obtenir le code instrument connaissant le code artiste. U n appel a 

key( "PlagesParCodesArtistes", SidArtiste ) 

renvoie les plages ou I 'artiste intervient, a condition bien sur que cet appel soit place dans 
un xsi : for-each pour que le noeud contexte indique le bon arbreXM L, commea la sec- 
tion precedente (voir Instanciation des Nos de plages, page 463). Ayant I'ensemble des 
plages pour un artiste donne, on considere I 'une d'el le, peu importe laquelle. La premiere 
est le choix le plus simple, car si cet ensemble n'est pas vide, on est sur que la premiere 
existe : 

<xsl :variable name="unePl ageAvecCetArti ste" 

select^' key( "PI ages Pa rCodes Artistes" , 
$idArtiste )[1]' /> 

Ayant une plage, par exemple : 

<plage No="3" vdg="cplu" clv="nspt" 
thb="eblq" vll="fmrt" 

vl2="oded"> Adagio </plage> 

et connaissant le code artiste, par exemple "epiu", il faut en deduirelenom de I 'attri but 
dont la valeur est "epiu" (ici vdg). Dans I'ensemble des attributs de la plage courante, il 
faut done recuperer celui dont la valeur est cell edu code artiste donne : 

SunePlageAvecCetArtiste/attribute: :*[ . = SidArtiste ] 

Ayant I 'attri but (qui est un noeud de type attribute), il n'y a plus qu'a appeler la fonc- 
tion predefinie local -name qui va renvoyer son nom, correspondant au code instrument ; 
ce qui nous donne le modele nomme d'instanciation de ce code instrument 

<xsl :template name="instancier-codeInstrument"> 
<xsl:param name="idArtiste"/> 
<xsl :for-each sel ect="document( 'PlagesCD.xml ' )"> 
<xsl :variable name="unePlageAvecCetArtiste" 

sel ect=' key( "PI agesParCodesArti stes" , 
SidArtiste )[!]' /> 
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<xsl :value-of select="local-name( 

$unePl ageAvecCetArtiste/attribute: :* 
[ . = SidArtiste ] )" /> 

</xsl :for-each> 
</xsl :template> 

Programme complet 

En reunissant tous les morceaux, on obtient finalement le programme suivant : 

distribution.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl :key name="Pl agesParCodesArti stes" 

match="pl age" use="attribute: :*" /> 

<xsl :key name="InstrumentsParCodesInstruments" 

match="instrument" use="attribute: :id" /> 

<xsl :variable name="racinePlages" select="document( 'plagesCD.xml ' )" /> 



<!-- ========================================== --> 

<xsl :template name="instancier-NomArtiste"> 
<xsl :param name="nomArtiste"/> 

<xsl :text> </xsl :text> 

<xsl :cal 1 - tempi ate name="instancier-sautl_igne"/> 

<xsl :value-of select="$nomArtiste"/> 
<xsl :cal 1 - tempi ate name="instancier-sautl_igne"/> 
</xsl :template> 



<!-- ========================================== --> 

<xsl :template name="instancier-NosPlagesAvecCetArtiste"> 
<xsl:param name="codeArtiste"/> 

<xsl :for-each select="$racinePlages"> 

<xsl :for-each select='key( "PlagesParCodesArtistes" 

$codeArtiste )'> 
<xsl :value-of select="@No"/> 
<xsl:text> </xsl:text> 
</xsl :for-each> 
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</xsl :for-each> 



</xsl :templ ate> 



<! 



> 



<xsl :template name="instancier-NoinInstruinentDeCetArtiste"> 
<xsl :param name="codeArtiste"/> 
<xsl :variable name="codeInstrument"> 

<xsl :cal 1 -tempi ate name="instancier- code Instruments 

<xsl :with-param name="idArtiste" select="$codeArtiste"/> 
</xsl : call -tempi ate> 
</xsl :vari abl e> 

<xsl :val ue-of select='key( "InstrumentsParCodesInstruments" , 



<xsl :template name="instancier-codeInstrument"> 
<xsl:param name="idArtiste"/> 
<xsl :for-each select="$racinePlages"> 

<xsl :variable name="unePlageAvecCetArtiste" 

select^' key( "PI ages Pa rCodes Artistes" , 
SidArtiste )[1]' /> 

<xsl :value-of sel ect="l ocal -name( 

$unePl ageAvecCetArti ste/attribute: :* 
[ . = $idArtiste ] )" /> 

</xsl : for-each> 
</xsl :templ ate> 

<;-_ ========================================== --> 

<xsl :template name="instancier-sautl_igne"> 
<xsl :text> 
</xsl :text> 

</xsl :templ ate> 



<i — ========================================== --> 

<xsl :template match="artiste"> 



$codeInstrument )/attribute: mom' /> 



<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl :templ ate> 



<! 



> 



<xsl :cal 1 -tempi ate name="instancier-NomArtiste"> 

<xsl :with-param name="nomArtiste" select="@nom"/> 
</xsl :call-template> 
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<xsl :cal 1 -tempi ate name="instancier-NosPl agesAvecCetArti ste"> 

<xsl :with-param name="codeArtiste" select="@id"/> 
</xsl :call-template> 

<xsl :cal 1 -tempi ate name="instancier-NomInstrumentDeCetArtiste"> 

<xsl :with-param name="codeArtiste" select="@id"/> 
</xsl :call-template> 

</xsl :templ ate> 



<i— ========================================== --> 

<xsl :templ ate match="text( ) "/> 



</xsl :stylesheet> 

Pattern n° 13 - Generation d'hyper liens 

Motivation 

Dans la section precedente (voir Pattern n°12 - References croisees inter /zchiers, 
page 459), il s'agissait de suivre des references en passant de fichier en fichier ; ici le pro- 
bl erne est degenerer des hyper-liens. Typiquement, en HTM L, ces hyper liens seront des 
paires <a name="..."> <a href=" ...">. Si HTM L est cite ici en exemple, c'est unique- 
ment parce que les balises <a> sont bien connues ; mais le probleme est exactement le 
meme pour n'importe quel texte ou I'on doitemettre des references a d'autres parties du 
document, et se resout de la meme facon. 

On serestreintici aun seul document, maissi I'on voulaitemettredes references de type 
<a href=" . . . "> vers un autre document, il suffirait de combiner I es i dees mises en ceuvre 
dans cette section, avec celles de la section precedente (Pattern n°12 - References 
croisees interveners, page 459). 

L'idee de base, ici, est d'utiliser la fonction generate-id( ) pour obtenir une chaine de 
caracteres qui pourra servir d'identifiant pour une ancre referencable. 

U ne autre idee est que nous sommes ici dans un domai ne ou la notion de cle d'indexation 
a des chances d'etre utile. 

Prenons par exemple ce fichier XML: 

Saison.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<Saison> 

<Periode> Automne 1999 </Periode> 
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<Manifestations> 
<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Manifestations> 

<Adresse> 

<Lieu>Chapel 1 e des Ursul es</Lieu> 

9, rue des Ursules - 49000 Angers 
</Adresse> 

<Adresse> 

<Lieu>Salle des Cordeliers</Lieu> 

1, rue des Prevoyants de l'avenir - 49000 Angers 
</Adresse> 

</Saison> 

On veut obtenir une version HTLM de ce document, avec un lien actif de chaque lieu 
vers son adresse. Done, arrive sur un <Lieu> de concert ou de theatre, il faut referencer 
le <Lieu> correspondant, enfant de <Adresse>. Pour cela, il faut chercher, parmi les 
enfants d'elements <Adresse>, un <Lieu> dont la valeur textuelle soit la meme que 
celle de I'element <Lieu> courant. A ce <Lieu> ainsi trouve, on associera un i denti fiant 
par la fonction generate-id( ), et cet identi fiant servira ensuite de reference pour les 
balises <a>. 

Si les references a emettre sont peu nombreuses, et le document a traiter peu vol umi neux, 
cela peut rester acceptable de rechercher le <Lieu> parmi les <Adresse> a chaque fois 
qu'on a besoin d'emettre un <a href=" . . .">. M ais dans le cascontraire, il est beaucoup 
plus efficacedeconstruire unecle d'indexation des <Lieu>. 

Realisation avec recherche par cle 

La cle est ici a construire en recoltant des <Lieu> enfants d'elements <Adresse>, en 
prenant la valeur textuelle du <Lieu> comme valeur de cle : 



<xsl:key name="l ieux" match="Adresse//Lieu" use="." /> 



Patterns de transformation 

Chapitre 9 



Les ancres a generer sont soit de la forme <a href=". ..">, soit de la forme <a name= 
" . . . ">. Dans les deux cas, I 'attri but sera egal a#abc, ou abc est une chaine de caracteres 
caracteristique, fournie par la fonction generate-id( ). 

Done, connaissant la valeur I itteral e d'un lieu, par exemple chapeiie des ursuies, on 
recherche le <i_ieu> correspondant par la fonction key( ). Le resultat est necessai rement 
un node-seta un et un seul element : on transmetdonc cet element a generate-ido, etla 
valeur renvoyee va constituer la fin de la reference (le debut etant le caractere ■#'). Par 
exemple, 

<a name="#{generate-1d(key( 'Heux' , 'Chapeiie des Ursul es ')) }"> 

genere la balise HTM L : 

<a name="#d0e56"> 

La valeur d0e56 n'est pas predictible, bien sflr ; ici, e'est un exemple obtenu avec Saxon. 

Remarquez la facon dont le descripteur de valeur differee d'attri but est employe: 
"#{ . . . }. Apres leguillemet, la valeur de I 'attri but commence par un ■#•. Ensuitevient le 
descripteur, introduit par le caractere '{'. Le descripteur estevalue, et sa valeur vient 
s'ajouter au ■#■ deja pris en compte. On aurait eventuellement pu tout calculer dans le 
descripteur : 

<a name="{concat( '#' , generate-id( key( 'lieux' , 'Chapeiie des Ursul es ')))} "> 

Un programme possible detraitementdecefichierXM L est done lesuivant: 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'html ' encoding='IS0-8859-l' /> 
<xsl:key name="lieux" match="Adresse//Lieu" use="." /> 



<xsl :templ ate match="/"> 
<html> 
<head> 

<title>Programme Saison 
<xsl : val ue-of 

sel ect= " /Sai son /Peri ode "/> 
</title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :templ ate> 



Pattern n 13 - Generation d'hyper liens 

Chapitre 9 



<xsl : tempi ate match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl :apply-templates sel ect="Adresse"/> 
</xsl :templ ate> 

<xsl :template match="Concert|Theatre"> 

<H3Xxsl :val ue-of sel ect="l ocal -name( . ) "/> </H3> 
<p>Date : <xsl :value-of sel ect="Date"/> <br/> 

Lieu : <a href="#{generate-id(key( 'lieux' , ./Lieu))}"> 
<xsl :val ue-of select="Lieu"/> 
</a> 

</p> 
</xsl :templ ate> 

<xsl : tempi ate match="Adresse"> 

<p><a name="#{generate-id( key( ' 1 ieux' . ./Lieu)))"> 
<xsl :val ue-of select="Lieu"/> 
</a> 
<br/> 

<xsl : val ue-of sel ect=" ./child: : text( ) [2]"/> 
</p> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 



</xsl :stylesheet> 

On notera la facon d'obtenir letexteassocie a uneadresse : 

<xsl : val ue-of select="./child::text()[2]"/> 

Le texte utile est le deuxieme, car le premier n'est compose que d'espaces blancs : ce sont 
lesespacesblancs situes entre la fin dela balise <Adresse> et le debut dela balise <i_ieu>. 

Une alternative serait d'utiliser ['instruction <xsi :stn"p-space> qui supprime tous les 
nceuds text ne contenant que des espaces blancs. Cette solution est meilleure dans la 
mesure ou elle evite d'avoir a gerer I 'invisible. Nous la mettrons en ceuvre dans la variante 
dela prochaine section, atitre de comparaison. 

Le resultat obtenu avec Saxon est donne ci-dessous (les valeurs d'ancres dependent du 
processeur utilise) ; voiraussi la figure 9-2. 

Saison.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<title>Programme Saison Automne 1999 </title> 
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</head> 

<body bgcolor="white" text="bl ack"> 
<H3>Concert</H3> 

<p>Date : Samedi 9 octobre 1999 20H30 <br> 

Lieu : <a href="#d0e56">Chapel 1 e des Ursul es</a></p> 
<H3>Théâtre</H3> 
<p>Date : Mardi 19 novembre 1999 21H <br> 

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Théâtre</H3> 
<p>Date : Mercredi 20 novembre 1999 21H30 <br> 

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Adresses :</H3> 

<p><a name="#d0e56">Chapelle des Ursules</aXbr> 
9, rue des Ursules - 49000 Angers 

</p> 

<p><a name="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Prévoyants de 1'avenir - 49000 Angers 



</p> 
</body> 
</html> 



Figure 9-2 

Rendu HTM L du 
,/j'chier Saison.html 



■An}*} 



J Fichiet Edition Affichage Favor w 



Liens 



Concert 

Date : Samedi 9 Octobre 1999 20H30 
Lieu : Chapelle des Ursules 



Theatre 



Date : Mardi 19 Novembre 1999 21H 
Lieu : Salle cles Cordeliers 



Theatre 



Date : Mercredi 20 Novembre 1999 21H30 
Lieu : Salle des Cordeliers 



Adresses : 



Chapelle des Ursules 

9, rue des Ursules - 49000 Angers 

Salle des Cordeliers 

1, rue des Pre voy ants de 1'avenir - 49000 Angers 



;g] file JUL .-/utilise Poste de travail 
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Realisation avec recherche par expression XPath 

II n'y a pas de difficult^ particuliere a utiliser une expression XPath pour rechercher un 
lieu de meme valeur textuel I e que le lieu courant ; leseul petit problemeest I'ecriture du 
predicatoii I 'on a besoin a lafoisdu nceud contexteet du nceud courant. Nousavonsdeja 
rencontre ce probleme et vu comment le resoudre : reportez-vous a la fin de la section 
Exemple, page 187. 

Le programme est donne ci-dessous ; le resultat est exactement identique au precedent. 

L'instruction <xsi :strip-space eiements="*" /> permet de supprimer de I 'arbre X M L 
les noeuds text ne contenant des espaces blancs; en consequence, ^instruction 
<xsi :vaiue-of sei ect=" . /chi i d : : text ( ) "/> est maintenant beaucoup plus naturelle 
que dans la version precedente. 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='html ' encodings' ISO-8859-1 ' /> 
<xsl :strip-space elements="*" /> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title> 

Programme Saison 

<xsl :value-of select="/Saison/Periode"/> 
</title> 
</head> 

<body bgcol or="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :templ ate> 

<xsl :template match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl :apply-templates sel ect="Adresse"/> 
</xsl :templ ate> 

<xsl :template match="Concert|Theatre"> 

<H3Xxsl :val ue-of sel ect="l ocal -name( . )"/> </H3> 
<p>Date : <xsl :value-of sel ect="Date"/> <br/> 

Lieu : <a href="#{generate-id(/Saison/Adresse/Lieu 

[ . = current( )/Lieu ] 

)}"> 
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<xsl :val ue-of select="Lieu"/> 
</a> 

</p> 
</xsl :template> 

<xsl : tempi ate match="Adresse"> 

<p><a name="#{generate-id( ./Lieu)}"> 
<xsl :val ue-of select="Lieu"/> 
</a><br/> 

<xsl : val ue-of sel ect=" ./child: : text( ) "/> 
</p> 
</xsl :templ ate> 

<xsl : tempi ate match="text( ) "/> 



</xsl :stylesheet> 

Pattern n° 14- Regroupements 

Motivation 

L e regroupement est un probleme tres frequent dans les transformations X SLT. 1 1 se pose 
a chaquefois que le document X M L a traiter contient des informations disseminees ici et 
la, mais ayant toutes un point commun (par exemple, des villes, qui font toutes parti e 
d'un pays ; des instrumentistes, qui jouent tous d'un certain instrument ; des pieces (de 
maisons), qui ont toutes une certaine surface, etc.). II y a plusieurs sortes de regrou- 
pements, qui dependent de ce qu'on veut obtenir, et du point de vue adopte pour decider 
du point commun a considerer. 

Dans un regroupement par valeur, le probleme consiste a produire un document resultat 
dans lequel par exemple les villes sont regroupees par pays, les instrumentistes par 
instrument, les pieces par surface, etc. 

Dans un regroupement positionnel, le but est de rassembler des elements dont les posi- 
tions (au sein d'unecertaineliste) sont identiques d'un certain point de vue. Par exemple, 
on a une I iste devil les, et on veut les regrouper trois par trois. 

Enfin, une derniere categorie de regroupement est la restauration hierarchique de docu- 
ments XML. II s'agit ici de reconstituer la structure hierarchique d'un document XML 
qui a ete « aplati » pour une raison quelconque. Un exemple de document plat a deja 
ete rencontre (voir lefichier company. xmi, a la section Exemple plus e'volue, page 275) ; 
la restauration hierarchique d'un tel document consisterait a reconstituer un vrai docu- 
ment XML: 

Fichier aplati 

<?xml version="1.0" encoding="UTF-16" ?> 
<table name="COMPANY"> 



Pattern n 14- Regroupements 

Chapitre 9 



N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 

</table> 

Fichier restaure 

<?xml version="1.0" encoding="UTF-16" ?> 
<table name="COMPANY"> 
<field> 

<name>NOACA</name> 
<type>CHAR(6X/type> 
</field> 
<field> 

<name>LSACAK/name> 
<type>VARCHAR2(35X/type> 
</field> 
etc. 
</table> 



Remarque 

La future version 2.0 de XSLT devraitinclure des possibilities pour specifier des regroupements, parce que tout 
le monde s'accorde a reconnaitre que les regroupements ne sont pas simples a programmer, alors qu'ils font 
partie du quotidien. 



Regroupements par valeur ou par position 

D'une facon generale, on peut dire qu'on a identifie un probleme de regroupement par 
valeur quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contient certains nceuds N d'un certain type pour lesquels on dispose 
(au moinsconceptuellement) d'une certainefonction valeur, telle que vaieur(N) ren- 
voie un resultat qu'on peut appeler la valeur de N . Suivant ce point de vue, la valeur 
d'un ville, c'est son pays ; la valeur d'un instrumentiste, c'est son instrument ; et la 
valeur d'une piece, c'est sa surface. 

2) Le document resultat doit contenir les nceuds N regroupes par valeurs identiques. 

Un regroupement par position est en fait un cas particulier du precedent, oil la valeur 
d'un element est liee a sa position au sein d'une certaine liste. La position etant donnee 
par un nombre entier, la valeur d'un element, dans ce cas, est done numerique. Par exem- 
ple, si I'on a une liste de villes a regrouper trois par trois, on prendra pour valeur d'une 
ville le tiers de sa position dans cette liste, de telle sorte que chaque groupe de trois soit 
constitue de villes de meme valeur. 
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Dans son principe, la solution consisted proceder en deux etapes : 

• Etape 1: on commence par constituer I 'ensemble NVD des noeuds de type T de 
valeurs toutes differentes. 

• Etape2 : on parcourt(2a) I'ensemble NVD, et pour chaque nceud (ayant une certaine 
valeur v) de cet ensemble, on selectionne (2b) I'ensemble des noeuds de type T de 
I'arbreXML qui ontv pour valeur : ces noeuds sont regroupes par valeur. 

L'etape 1 est done une etape de constitution d'un ensemble de valeurs toutes differentes ; 
or nous avons deja vu comment resoudre ce probleme (voir Node-set de valeurs toutes 
differentes, page 438). La methode de Steve M uench est parti culierement recommandee 
ici, car el I e est basee sur la construction d'une cle, qui va aussi servir dans l'etape 2, en 
rendant sa mise en oeuvre parti culierement simple. 

Des pieces regroupees par surface habitable (regroupement par valeur 
d'attributs) 

Nous allons continuer le memeexemplequ'a la section Node-set de valeurs toutes diffe- 
rentes, page 438, afin de pouvoir reprendre la realisation obtenue par la methode de la 
cle. 

L e fichier XML a traiter est le suivant : 
maisons.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<maisons> 

<maison id="l"> 
<RDC> 

<cuisine surface='40m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 

<bureau surface='15m2'> 
Bibliotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palmier en zinc figurant le desert. </terrasse> 
<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre=T> 
Lambris. 

</al cove> 
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</chambre> 

<chambre surface='15m2'> 

Lambris. 
</chambre> 

<salleDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="2"> 
<RDC> 

<cuisine surface='28m2'> 

en ruine. 
</cuisine> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

vue sur la mer 
</terrasse> 

<salleDeBains surface='15in2'> 

Douche. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="3"> 
<RDC> 

<sejour surface='40m2'> 

paillasson a 1 'entree 
</sejour> 
</RDC> 
<etage> 

<chambre surface='28m2'> 

porte cochere. 
</chambre> 
</etage> 
</maison> 
</maisons> 

Lefichier que I'on souhaiteobtenirestcelui-ci : 
pieces.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<piecesParSurfaces> 



<pieces surface="40m2"> 

<cuisine idMaison="l">Evier inox. Mobilier encastre.</cuisine> 
<sejour idMaison="l">Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree.</sejour> 
<sejour idMaison="3">paillasson a 1 'entree</sejour> 

</pieces> 
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<pieces surface="15m2"> 

<bureau idMaison="l">Bibl iotheque encastree.</bureau> 
<chambre idMaison="l">Lambri s .</chambre> 

<sal 1 eDeBains idMaison="l">Douche, baignoire, lavabo.</salleDeBains> 
<salleDeBains idMaison="2">Douche.</sal leDeBains> 
</pieces> 

<pieces surface="28m2"> 

<chambre idMaison="l">Carrel age terre cuite poncee.</chambre> 
<cuisine idMaison="2">en ruine.</cuisine> 
<chambre idMaison="3">porte cochere.</chambre> 
</pieces> 

<pieces surface="8m2"> 

<al cove idMaison="l">Lambri s .</al cove> 
</pieces> 

</piecesParSurfaces> 

La realisation de I'etape 1 a deja ete faite, nousavions obtenu la cle : 

<xsl :key name="groupesdeSurfacesParVal eurs" 
match="attribute: :surface" 
use="." /> 

et nous avions obtenu I'expression qui donne I 'ensemble des valeurs toutes differentes : 

C reation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-id( ) = 
generate-id( 

key( 'groupesdeSurfacesParValeurs ' , . ) [1] 

) 

] 

La realisation de I'etape 2 est tres simple : il suffit de parcourir I 'ensemble obtenu, cequi 
va nous donner des valeurs toutes differentes, et ensuite, pour chaque valeur, d'exploiter 
la cle pour obtenir les nceuds possedant cette valeur. 

maisons.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xml ' encodings' ISO-8859-1 ' indent="yes" /> 

<xsl :key name="groupesdeSurfacesParVal eurs" 
match="attribute: :surface" 
use="." /> 



<!-- 
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Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl :variable name="lesDifferentesSurfaces" 
select="//attribute: :surface[ 
generate-id( ) = 
generate-id( 

key( 'groupesdeSurfacesParVal eurs ' , . ) [1] 

) 

]" /> 

<!-- 

================================================================== --> 



<xsl : tempi ate match="/"> 
<piecesParSurfaces> 
<! — 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentesSurfaces" > <!-- 
=============================================== --> 

<! — 

ici le nceud courant est un nceud attribute: :surface 

--> 

<xsl :variable name="val eurCourante" select="." /> 

<pieces surface="{$val eurCourante) "> 

<! — 

Etape 2B : parcours des niEuds ayant cette valeur 
==================================================== -_> 

<xsl :for-each sel ect="key( 'groupesdeSurfacesParValeurs' , 

SvaleurCourante)" > <!-- 
==================================================== -_> 

<! — 

ici le nceud courant est un nceud attribute: :surface 

--> 

<xsl variable name="pieceCourante" 

select=" . /parent : :node( )" /> 

<xsl : element name="{ local -name($pieceCourante)}"> 
<xsl attribute name="idMaison"> 
<xsl :val ue-of select=" 
SpieceCour ante/ancestor: :maison/@id"/> 
</xsl :attribute> 
<xsl :val ue-of select=" 

normal ize- space ($pieceCourante/chi Id: : text( ) )"/> 
</xsl :el ement> 
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</xsl :for-each> 
</pieces> 
</xsl :for-each> 
</piecesParSurfaces> 
</xsl :templ ate> 



</xsl :stylesheet> 

Le resultat obtenu est exactement celui montre ci-dessus (a part quelques sauts de lignes 
ajoutes pour la lisibilite). 

Les villes regroupees par pays (regroupement parvaleurd'attributs) 

On suppose qu'on a un fichier XM L donnant une liste de villes avec, pour chacune, son 
pays: 

villes.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Villes> 

<Ville nom="Paris" pays="France" /> 
<Ville nom="Madrid" pays="Espagne" /> 
<Vi lie nom="Mi 1 an" pays="Italie" /> 
<Vi lie nom="Rome" pays="Ital ie" /> 
<Ville nom="Angers" pays="France" /> 
<Vi lie nom="Barcel one" pays="Espagne" /> 
<Ville nom="Venise" pays="Ital ie" /> 
<Vi lie nom="Cordoue" pays="Espagne" /> 
< V i 1 1 e nom="Napl es" pays="Italie" /> 
</Villes> 

On veut la liste des villes par pays. La methode est exactement la meme, bien que le 
fichier XM L a traiter soit d'un structure assez differente : 

villes.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/lransform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-l' /> 

<xsl :key name="groupesDePaysParNoms" 
match="attribute: :pays" 
use="." /> 

<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl :variable name="lesDifferentsPays" 
select="//attribute: :pays[ 
generate-id( ) = 



Pattern n 14- Regroupements 

Chapitre 9 

generate-id( 

key( 'groupesDePaysParNoms' , . )[1] 

) 

]" /> 

<!-- 

================================================================== --> 

<xsl : tempi ate match="/"> 
<!-- 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentsPays"> <!-- 
=============================================== --> 

<!-- 

ici le nffiud courant est un nuud attribute: :pays 
--> 

- <xsl :value-of select="."/> : 

<xsl :variable name="tousLesAttributsPaysDeMeineValeur" 

select="key( 'groupesDePaysParNoms' , .)" /> 

<! — 

Etape 2B : parcours des ncuds ayant cette valeur 
========================================================= _-> 

<xsl :for-each select="$tousl_esAttributsPaysDeMemeValeur"> <!-- 
========================================================= -> 

<! — 

ici le nffiud courant est un ncud attribute: :pays 
--> 

<xsl variable name="l aVi 1 1 eCorrespondante" 
select^". /parent: :node( )" /> 
. <xsl :value-of sel ect="$l aVi 1 1 eCorrespondante/@nom"/> 

</xsl :for-each> 
</xsl :for-each> 

</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

- France : 

. Paris 
. Angers 

- Espagne : 



Madrid 
Barcel one 
Cordoue 
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- Italie : 



. Milan 

. Rome 

. Venise 

. Naples 



Les instrumentistes regroupes par instruments (regroupement parvaleur 
de noeuds texte) 

Dans les deux exemples precedents, les valeurs servant de valeur de cle etaient des 
valeurs d'attri buts. Ce n'est nullement une obligation : cet exemple va le montrer. 

On partd'un fichier XML commececi : 
Concert.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 



<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Mardi 11 Fevrier 2003, 20H30</Date> 
<l_ieu>Chapelle des Ursules</I_ieu> 

<Ensemble> Hesperion XXI </Ensemble> 

<Interprete> 

<Nom> Jordi Savall </Nom> 

<Instrument>Dessus de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Wieland Kuijken </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sophie Wati 1 1 on </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sergi Casademunt </Nom> 
<Instrument>Tenor de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
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<Interprete> 

<Nom> Marianne Muller </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Philippe Pierlot </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<TitreConcert> 

Fantasias for the Viols (1680) 
</TitreConcert> 

<Composi teur>Henry Purcel 1 </Composi teur> 
</Concert> 

Et on veut obtenir la distribution du concert, classee par instruments. Ici, les « valeurs » 
d'instruments sont leurs noms, qui ne sont pas des attributs, mais des nceuds texte. 

distribution.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl :key name="groupesInterpretesParInstruments" 
match="Instrument" 
use="." /> 

<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl :variable name="lesDifferentsInstruments" 
sel ect="// Instrument [ 



generate-id( ) = 
generate-id( 

key( 'groupesInterpretesParlnstruments' , . )[1] 



]" /> 



<!-- 



> 



<xsl :template match="/"> 
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<! — 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentsInstruments" > <!-- 
=============================================== --> 

<!-- 

ici le nffiud courant est un nceud <Instrument> 
--> 

<xsl ivariable name="val eurCourante" select^"." /> 
- <xsl :val ue-of sel ect="$val eurCourante"/> 
<!-- 

Etape 2B : parcours des <Instrument> ayant cette valeur 
==================================================== --> 

<xsl :for-each select="key( 'groupesInterpretesParlnstruments' , 

$valeurCourante)" > <!-- 
==================================================== -_> 

<!-- 

ici le nffiud courant est un naud <Instrument> 
--> 

<xsl ivariable name="instrumentiste" 

select=". /parent: ilnterprete" /> 
. <xsl :val ue-of select="$instrumentiste/Nom"/> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :template> 



</xsl :stylesheet> 
Resultat 



Dessus de viole 
. Jordi Savall 



- Hautecontre de viole 

. Wieland Kuijken 
. Sophie Watillon 

- Tenor de viole 

. Sergi Casademunt 

- Basse de viole 

. Sylvia Abramowicz 
. Marianne Muller 
. Philippe Pierlot 
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Les villes trois partrois (regroupement positionnel) 

Leproblemeesttres simple : on a unelistede villes, eton veut les afficher sous la forme 
d'un tableau de trois colonnes par ligne. Nous reprenons done le meme fichier que celui 
qui a servi pour regrouper les villes par pays : 

villes.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Villes> 

<Ville nom="Paris" pays="France" /> 
<Ville nom="Madrid" pays="Espagne" /> 
<Ville nom="Mi 1 an" pays="Ital ie" /> 
<Ville nom="Rome" pays="Ital ie" /> 
<Ville nom=" Angers" pays="France" /> 
<Ville nom="Barcelone" pays="Espagne" /> 
<Ville nom="Venise" pays="Italie" /> 
<Ville nom="Cordoue" pays="Espagne" /> 
<Ville nom="Naples" pays="Italie" /> 
</Villes> 

Le fichier a obtenir est le suivant : 



vi11es.html 

<htm1> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 



<title> Les villes </title> 
</head> 

<body text="black" bgcol or="white"> 
<table> 
<tr> 

<td>Paris</td> 
<td>Madrid</td> 
<td>Milan</td> 
</tr> 
<tr> 

<td>Rome</td> 
<td>Angers</td> 
<td>Barcelone</td> 
</tr> 
<tr> 

<td>Venise</td> 
<td>Cordoue</td> 
<td>Naples</td> 
</tr> 
</table> 
</body> 
</html> 
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Le principe n'est pas different, malgre le fait que le regroupement soit ici positionnel : il 
suffit de se ramener a un poi nt de vue dans I equel la valeur d'une ville est mai ntenant non 
plus son pays, maissa position au sein de lafratriedes villes. 

La premiere etape sera done comme d' habitude de constituer une cle de regroupement 
par valeur. 

<xsl :key name="lesVillesParPosition" 
match="Ville" 
use="??" /> 

Neanmoins, le probleme est ici de definir la position de la ville courante, lors de deva- 
luation de I 'expression XPath fournie par I ' attri but use. 

Remarque importante 

II faut ici se souvenir que cette expression XPath est evaluee avec le noeud en concordance comme nceud 
contexte, et une liste reduite au seul nceud contexte comme liste contexte, Si bien que la fonction predefinie 
positiont ) ne peut que renvoyer la valeur 1, si on I'appelle quelque part au sein de cette expression. II faut 
done definitivement abandonner I'idee d'utiliser cette fonction dans une expression pour le calcul de la valeur 
d'une cle, si on I'avait jamais eue : une fonction qui renvoie toujours 1 n'est pas vraimentdes plus utiles. 

Ici, la liste interessante n'est done pas la liste contexte formee lors de revaluation de 
I'expression attri but de use, mais le node-set des <viiie>, enumere dans I'ordre de lec- 
ture du document, qui donne la numerotation (en partant arbitrairement de 0) 0 (Paris), 

I (Madrid) 8 (Naples). 

Pour une <viiie> donnee, son numero est done egal au nombre d'elements contenus 
dans le node-set des <v-n ie> qui sont des preceding-si bi ing de la <vm e> courante. Si 
done I'on evalue I'expression 

preceding-sibl ing: :Ville 

par rapport a un nceud contexte qui est une <vi iie>V quelconque, on obtient le node-set 
detoutes les villes situees avantV dans I'ordre de lecture du document. 

L'expression qui donne la position d'une telle <vm e> V est done : 

count( preceding-sibling: :Ville ) 

si toutefois I 'evaluation a bien lieu par rapport au nceud contexte V. 

II est done possible, maintenant, de determiner I'expression qui va fournir la valeur de 
regroupement des villes : 

<xsl :key name="lesVillesParPosition" 
match="Ville" 

use="floor( count(preceding-sibl ing: :Ville) div 3 )" /> 

L'operateur div est la division ; les calculs sefaisant en nombres reels double precision, 
il est necessai rede prendre la partie entiere du quotient obtenu, d'ou I'appel a la fonction 

floorO. 
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Avec cette definition de cle : 

• les villes Paris, M adrid, et M i I an ont pour valeur 0 ; 

• les villes Rome, Angers, etBarcelone ont pour valeur 1 ; 

• les villes Venise, Cordoue, et Naples ont pour valeur 2. 

L'etape 1 consiste comme d'habitude a constituer I 'ensemble des elements de valeurs 
toutes differentes (ici des villes), mais c'est plus simple a real iser que dans les exemples 
precedents, car les villes qui vont constituer cet ensemble ont un numero que I'on peut 
calculer a I'avance : ce sont les villes numerotees 0 (Paris), 3 (Rome), et 6 (Venise), qui 
ont respectivement pour valeur 0, 1, et 2. L'initialisation de la variable contenantle node- 
set des villes de valeurs toutes differentes va done pouvoir s'ecrire : 

<xsl :variable name="lesDifferentsGroupesDeVilles" 
select="//vme[ 

((positionO - 1) mod 3) = 0 
]" /> 

Ici, la fonction positionO peut etre utilisee, car el I e est appelee dans un predicat qui 
filtre un node-set constitue de toutes les villes : lors de devaluation du predicat, la liste 
contexte est constitute des elements du node-set a filtrer, done la fonction positionO 
renvoie la position de la ville courante au sein de cette liste, ce qui donne le resultat 
attend u. 

On peut done maintenantecrirele programme, dont le plan reprend tres exactementcelui 
des autres exemples de regroupements que nous avons deja vus. 

villes.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='html ' encodings' ISO-8859-1' /> 

<xsl :variable name="facteurDeRegroupement" select="3"/> 

<xsl :key name="lesVillesParPosition" 
match="Vi 1 1 e" 

use="floor( counttpreceding-sibling: :Ville) div 3 )" /> 



<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl :variable name="lesDifferentsGroupesDeVilles" 
select="//vme[ 

((positionO - 1) mod SfacteurDeRegroupement) = 0 
]" /> 

<!-- 

================================================================== - > 
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<xsl rtempl ate match="Villes"> 

<table> 
<! — 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentsGroupesDeVilles"> <!-- 
=============================================== --> 

<!- 

ici le noeud courant est un noeud Ville 

(la premiere de chaque ligne du tableau) 

Sa valeur de cle est donnee par positionO - 1 

--> 

<xsl : vari abl e name="valCle" select="position() - 1" /> 

<tr> 
<!-- 

Etape 2B : parcours des noeuds ayant cette valeur 
========================================================= --> 

<xsl :for-each select="key( ' lesVil 1 esParPosition ' , $valCle)"> <!-- 
========================================================= --> 

<!-- 

ici le noeud courant est une ville 

--> 

<td><xsl :value-of select="@nom"/X/td> 

</xsl :for-each> 

</tr> 
</xsl :for-each> 
</table> 

</xsl :template> 

<!-- --> 

<xsl :template match="/"> 
<html> 
<head> 

<title> Les villes </title> 
</head> 

<body text="black" bgcolor="white"> 
<xsl : apply-templ ates/> 
</body> 
</html> 
</xsl rtempl ate> 

</xsl :stylesheet> 

L e resul tat obtenu est eel ui montre pi us haut (flchier vines, html ) ; on observera I e desa- 
grement que procure I 'interdiction d'utiliser une reference de variable dans I 'attri but use 
de P instruction xsi :key. 
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Regroupements hierarchiques 

Les regroupements hierarchiques consistent a reconstituer explicitement une hierarchie 
d'elements, absente du document a traiter, mais neanmoins sous-jacente. Au lieu d'etre 
veritablement arborescent, avec des elements imbriques, I e document est en effetgenera- 
lement reduit a une structure lineaire d'elements juxtaposes. C'est ce qui explique qu'un 
regroupement hierarchique ne soit pas sans rapport avec un regroupement positionnel, 
dans la mesure ou la reconstitution du niveau hierarchique d'un element est en partie 
basee sur sa position dans la structure lineaire. 

La valeur d'un element sera done ici la place hierarchique que I 'element devra avoir dans 
le document resultat, ce qui est equivalent a dire que la valeur d'un element, c'est le 
nceud qu'il devrait avoir pour parent dans le document source. 

D'une facon general e, on peut affirmer qu'on a identifie un probleme de regroupement 
hierarchique quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contient certains nceuds N d'un certain type pour lesquels on dispose (au 
moins conceptuellement) d'une certaine fonction valeur, telle que vaieur(N) renvoie 
I'identite du nceud qui devrait etre le parent de N, si la hierarchie etait correctement 
respectee. 

2) Le document resultat doit contenir les nceuds N, reorganises (ou regroupes) de 
telle sorte que chaque noeud N ait pour parent un nceud dont I'identite est egale a 

val eur ( N ) . 

Dans son principe, la solution consiste a proceder en deux etapes : 

• Etape 1 : on commence par une reconstitution des relations hierarchiques. Chaque 
nceud n a traiter estassocie par une cle a sa valeur hierarchique (I'identite du nceud qui 
devrait etre le parent de n). A la fin de cette operation, il est done possible d'obtenir le 
node-set des enfants directs de chaque nceud p du document : en effet, connaissant p, 
on connait son identite I (generate- i d ( )), et la cle donnealors tous les elements ayant 
i pour valeur, e'est-a-diretous les elements ayant p pour parent. 

• Etape 2 : on parcourtla hierarchie, en partantdu sommet. Connaissant le sommet, on 
en deduit les enfants qu'il devrait avoir, grace a la cle obtenue a I'etape precedente, et 
on les construit dans le document resultat. II n'y a plus qu'a reprendre ce processus, 
non plus avec le sommet, mais avec chacun des enfants, etainsi de suite recursivement 
avec tout le reste de la hierarchie. 

Exemple generique 

Cetexempleestun exemple simple et generique, qui revientassez souvent sous diverses 
formes sur la mailing-list X SLT (www.biglist.com/lists/xsl-list/archives). 

Note 

On retrouvera cet exemple avec le moteurde recherche disponible a I'adresse ci-dessus : chercher « De-flatte- 
ning an XML tree ». 
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On part d'un fichier plat, commececi : 

flatDatas.xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<recordset> 
<record/> 
<data/> 
<data/> 
<record/> 

<data/> 
<record/> 
<data/> 
<data/> 
<data/> 
</recordset> 

et on veut reconstituer un fichier hierarchique, comme cela : 
Pitas .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recordset> 
<record> 

<data/> 

<data/> 
</record> 
<record> 

<data/> 
</record> 
<record> 

<data/> 

<data/> 

<data/> 
</record> 
</recordset> 

Premiere etape 

Dans la premiere etape, il s'agit de reconstituer la hierarchie sous-jacente. L'idee est 
done de rattacher chaque element a son parent : les <record> doivent etre rattaches au 
<recordset>, et chaque <data> au premier <record> qui apparait dans le sens inverse de 
celui de la lecture du document. Pour cela, on va affecter a chaque element une valeur 
egale a I'identite de son parent potentiel, et maintenir cette information grace a une de, 
donton peutvoir la structure a la figure 9-3. 

La figure 9-3 montre la structure plate du fichier XML, et comment retrouver les enfants 
directs d'un nceud : par exemple le <record> A correspond a la valeur VA, qui est la 
valeur du nceud <data> B, ce qui signifie que le <record> A a pour enfant I 'element 
<data> B. De meme, le noeud <recordset> correspond a la valeur VRS, qui est la valeur 
des trois nceuds <record>, ce qui signifie que le <recordset> a pour enfants les trois 
<record>. B i en sfir, cette derni ere valeur decle est redondanteavec la structure memede 
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I'arbre XM L de depart, qui donne deja cette information, mais il est plus simple de gar- 
der cette redondance pour regulariser la structure du programme, qui pourra ainsi tou- 
jours passer par la cle pour obtenir les enfants directs d'un nceud. 




Figure 9-3 

Cle pour retrouver les enfants directs d 'un nceud. 



Les elements <data> ne correspondent a aucune valeur, parce qu'ils n'ont pas d'enfants 
directs. 

En resume, si I'on considere I'ensemble des valeurs, et que I'on y choisit une valeur V 
quelconque, on peut dire que : 

• V correspond a un (et un seul) nceud N ; 

• V est la valeur d'un ensemble de nceuds E . 

On saitalors que le nceud N devrait avoir les nceuds E pour enfants. C'est pourquoi la cle 

est nominee "1 esEnfantsDi rects". 

Unefoisqu'on a vu la structure de la cle a obtenir, il n'y a plusqu'a trouver comment I'ini- 
tialiser. Partant d'un element E quelconque dans ledocumentoriginal, il s'agitde determiner 
son parent potenti el, etd'associer a E une valeur qui est I 'identi riant dece parent potenti el. 
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Mais il y a deux types d'elements dont il faut trouver les parents : les <data> et les 
<record>. Pour un noeud <data>, il faut rechercher le premier <record> en remontant 
vers la racine du document, et la valeur associee est dans ce cas I'identifiant de ce 
<record>. M ais pour un nceud <record>, il faut prendre le parent <recorset>, et I'identi- 
fiant de ce <recordset> est alors la valeur du noeud <record>. 

On est done dans un cas ou la cle doit etre constitute en deux fois: une premiere 
declaration pour le parent des nceuds <record>, et une deuxieme pour les parents des 
nceuds <data>, comme ceci : 

Premiere etape : initialisation de la cle des enfants directs 

<xsl : key 

name="l esEnfantsDi rects" 
match="record" 

use="generate-id( parent: : recordset )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="data" 

use="generate-id( preceding-sibling: :record[l] )" /> 

Cette facon de constituer une meme cle en deux fois est parfaitement autorisee, et le 
resultat est conforme a ce que montre la figure 9-3. 

Deuxieme etape 

La deuxieme etape est une etape de parcours recursif de la hierarchie memorisee dans la 
cle. U n tel parcours a une structure extremement reguliere que I 'on retrouvera a I 'identique 
dans tous les problemes de regroupements hierarchiques. 

On commence par le sommet de la hierarchie : 

Deuxieme etape : parcours hierarchique (debut) 

<xsl : tempi ate match="recordset" > 
<recordset> 

<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</recordset> 
</xsl : tempi ate> 

lei, I'on construit I 'element <recordset> en lui affectant pour enfants ceux que va nous 
donner la cle pour la valeur correspondant a I'identifiant du noeud courant, e'est-a-dire le 

<recordset>. 

Les enfants du <recordset> etant des <record>, il suffit maintenant d'ecrire une regie 

pour leS <record> : 

Deuxieme etape : parcours hierarchique (suite) 

|<xsl :templ ate match="record" > 
<record> 
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<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 

</record> 
</xsl : tempi ate> 

Les enfants d'un element <record> etant des <data>, qui sont des elements terminaux de 
la hierarchie, on va cettefoisecrire pour les elements <data> une regie non recursive, qui 
se contentera de recopier cet element dans le document resultat. 

On peut done maintenant donner le programme complet : 

unflatten.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 
<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl : key name="l esEnfantsDi rects" 
match="record" 

use="generate-id( parent: : recordset )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="data" 

use="generate-id( preceding-sibling: :record[l] )" /> 

<!-- 



Parcours recursif de la hierarchie 



--> 



<xsl :template match="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl :template match="recordset" > 
<recordset> 

<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</recordset> 
</xsl :templ ate> 
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<xsl : tempi ate match="record" > 
<record> 

<xsl :apply-templates 

select="key( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 

</record> 
</xsl rtempl ate> 

<!-- 



Elements terminaux de la hierarchie 



--> 

<xsl : tempi ate match="data" > 
<xsl :copy-of select="."/> 
</xsl rtempl ate> 



</xsl :stylesheet> 

Reconstitution hierarchique d'un texte 

Le programme que I'on vient de voir s'appliquait a un exemple tres simple, comportant 
une hierarchie presque triviale. Nous allons maintenant voir que si I'on s'attaque a la 
reconstruction d'une hierarchie beaucoup plus complexe, cela ne change rien a la struc- 
ture du programme, que I'on va done pouvoir reprendre integralement du programme 
precedent. Par contre, cequi peutdevenir un peu complique, e'estd'exprimer les concor- 
dances de motifs adequates pour les initialisations des valeurs de la de. 

Le probleme est maintenant de transformer un document XM L representant un texte 
(typiquement un livre ou un article), structure en chapitres, sections, etc., pour passer 
d'une representation plate a une representation hierarchique. Ce genre de probleme 
peut eventuellement se poser quand on veut adapter un texte existant a une nouvelle 
DTD. 

Ce probleme revient assez souvent et sous di verses formes sur la mailing-list XSLT : faire 
une recherche de « transforming an incorrectly structured document » sur www.google.fr , 
par exemple. 

Nous parti rons de I 'exemple suivant, assez representatif du probleme : 
texte .xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<document> 

<titreSectionl> titre A </titreSectionl> 
<p> para 1 </p> 

<titreSection2> titre A.l </titreSection2> 
<p> para 2 </p> 
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<p> para 3 </p> 
<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 
<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </titreSectionl> 

<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.l.l </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 

</document> 

L'indentation permet de mieux apprehender la structure du texte, mais il faut bien voir 
qu'il n'y a ici aucune imbrication d'elements. 

On veutecri re une transformation qui aboutissea ceci : 



texteReconstrtiit.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Document> 
<Sectionl> 

<titre> titre A </titre> 
<p> para 1 </p> 
<Section2> 

<titre> titre A.l </titre> 
<p> para 2 </p> 
<p> para 3 </p> 
<p> para 4 </p> 
</Section2> 
<Section2> 

<titre> titre A. 2 </titre> 
<p> para 5 </p> 
<Section3> 

<titre> titre A. 2.1 </titre> 
<p> para 6 </p> 
<p> para 7 </p> 
</Section3> 
</Section2> 
<Section2> 

<titre> titre A. 3 </titre> 
<p> para 8 </p> 
</Section2> 
</Sectionl> 
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<Sectionl> 

<titre> titre B </titre> 
<Section2> 

<titre> titre B.l </titre> 
<Section3> 

<titre> titre B.l.l </titre> 
<p> para 9 </p> 
</Section3> 
<Section3> 

<titre> titre B.l. 2 </titre> 
<p> para 10 </p> 
</Section3> 
</Section2> 
<Section2> 

<titre> titre B.2 </titre> 
<p> para 11 </p> 
</Section2> 
</Sectionl> 
</Document> 



Le programme general de reconstruction d'une hierarchie etant applicable ici, nous 
pouvons done tout de suite I'ecrire, en laissant en blanc ^initialisation de la cle : 



Ebauche de la transformation 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xml ' encodings' ISO-8859-1' indent='yes' /> 

<!-- 

Reconstitution des relations hierarchiques 

--> 

<xsl :key name="l esEnf antsDi rects" 
match="??" 
use="??" /> 

<xsl : key . . . /> 
<!-- 

Parcours recursif de la hierarchie 

--> 



<xsl :templ ate match="/"> 



Pattern n 14- Regroupements 




Chapitre 9 



<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl : tempi ate match="docuinent" > 
<Document> 

<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , gene rate- id( .))"/> 
</Document> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select="."/X/titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , gene rate- id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl :template match="titreSection2" > 
<Section2> 

<titre><xsl :value-of select="."/X/titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section2> 
</xsl :templ ate> 

<xsl :template match="titreSection3" > 
<Section3> 

<titre><xsl :value-of select="."/X/titre> 
<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section3> 
</xsl :templ ate> 



<!-- 



Elements terminaux de la hierarchie 



--> 



<xsl :templ ate match="p" > 

<P> 

<xsl : val ue-of sel ect=" . "/> 

</p> 
</xsl :templ ate> 



</xsl :stylesheet> 



On voit combien le programme est semblable au precedent, du moins pour ce qui est de 
I'etape 2, ou I'on doitfaire un parcours recursif de la hierarchie. 
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Pour etablir ^initialisation correcte de la de, il faut tout d'abord determiner la structure 
hierarchique possible, c'est-a-dire en fait la DTD du document resultat. II n'est pas 
necessaire de formaliser cela sous la forme d'une vraie DTD, il suffit ici de dire que : 

• un <Document> peut avoir pour enfantsdes <sectioni> ; 

• une <sectioni> peut avoir pour enfants des <p> ou des <section2> ; 

• une <section2> peut avoir pour enfants des <p> ou des <section3> ; 

• une <section3> peut avoir pour enfants des <p>. 

Le probleme etant de redonner a chaque element le parent qu'il devrait avoir dans la 
future hierarchie, i I faut done inverser la relation « a pour enfant » dans la listeci-dessus : 

• un <titreSectioni> devrait avoir pour parent I'element <document> ; 

• un <titreSection2> ou un <p>#i devrait avoir pour parent I'element <titreSectioni> 
[-i] ; 

• un <titreSection3> ou un <p>#2 devrait avoir pour parent I'element <titreSection2> 
[-i] ; 

• un <p>#3 devraitavoirpourparentl'element<titreSection3>[-i], 

Lanotation <p>#i designeici un element <p> qui esttel que si on remontedepuiscet ele- 
ment <p> vers la racine du document, le premier element rencontre qui ne soit pas un <p> 
est un <titreSectioni>. II en va de memeavec <p>#2 et <titreSection2>, avec <p>#3 et 

<titreSection3>. 

La notation <titreSectioni>[-i] designe le premier <titreSectioni> rencontre en 
remontant depuis le nceud contexte vers la racine, ce qui s'exprime techniquement par 
une expression XPath tres classique : 

preceding-sibl ing: :titreSectionl[l] 

On a lememe genre d'expression avec <titreSection2>[-i] et <titreSection3>[-i]. 

La seule reel I e difficult^ de ce programme reside dans I'ecriture d'un motif exprimant la 
notation <p>#n. M ais en procedant progressivement, depuis un node-set contenant tous 
les elements <p> sans distinction, que I'on filtre en enchainant les predicats adequats, on 
parvient au resultat cherche. 

Voyonscelasurlecasde<p>#i ; il faut parti rde tous les elements <p> : 

p 

On ne retientqueceux dont I 'axe preceding-si bi ing, reduitaux elements non <p>, n'est 
pas vide : 

p[preceding-sibl ing: :*[not(self : :p)]] 

Maintenant, on ne retientque ceux dont I'axe preceding-sibling, reduitaux elements 
non <p>, n'est pas vide etpossedeun premier element qui estun <titreSectioni> : 

p[ preceding-sibl ing: :*[not(self : :p)][l][self : :titreSectionl]] 
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Arrive a ce stade, on a de quoi initialiser parti ellement la de ; on reprend par exemple le 
deuxieme item de I 'enumeration ci-dessus : 

• un <titreSection2> ou un <p>#i devrait avoir pour parent I 'element <titreSectioni> 
[-i] ; 

II suffit detranscri re cette phrase en initialisation decle : 



name="l esEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :*[not(self : :p)][l][self: :titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

Des lors, on a tout ce qu'il faut pour terminer le programme completement : 
texte.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 



<xsl : key name="l esEnfantsDi rects" 
match="titreSectionl" 
use="generate-id( parent: :document )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :* [not (self : :p)][l][self: :titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 



<xsl : key 



<!-- 



Reconstitution des relations hierarchiques 



--> 



<xsl : key 



name="l esEnfantsDi rects" 
match="titreSection3 | 



p[preceding-sibl ing: 
use="generate-id( preceding 



*[not(self : :p)][l][self : :titreSection2]]" 
sibl ing: :titreSection2[l] )" /> 



<xsl : key 



name="l esEnfantsDi rects" 
match="p[preceding-sibl ing: 
use="generate-id( preceding 



*[not(self : :p)][l][self : :titreSection3]]" 
sibl ing: :titreSection3[l] )" /> 



<!-- 
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Parcours recursif de la hierarchie 



<xsl : tempi ate match="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl :templ ate match="document" > 
<Document> 

<xsl :apply-templates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Document> 
</xsl :template> 

<xsl :template match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select=" . "/X/titre> 
<xsl :apply-templates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSection2" > 
<Section2> 

<titre><xsl :value-of select^" . "/></titre> 
<xsl : apply-templ ates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section2> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSection3" > 
<Section3> 

<titre><xsl :value-of select=" . "/></titre> 
<xsl :apply-templates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section3> 
</xsl :templ ate> 



<!- 



Elements terminaux de la hierarchie 



<xsl : tempi ate match="p" > 
<P> 
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<xsl :val ue-of sel ect=" . "/> 

</p> 
</xsl : tempi ate> 



</xsl :stylesheet> 

Le resultat est conformed ce que I'on a montre au tout debut. 

M aintenant, la question que I'on pourraitse poser concerne la disproportion entre la fai- 
blevarietedes elements terminaux (uniquementdes <p>), et la complexity importantedes 
motifs de cle. Si Ton a un texte plus riche en elements terminaux, que va-t-il advenir de 
ces motifs? 

Supposons par exemple qu'il puissey avoir des <figure> en plus des <p>, commececi : 
texte .xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<document> 

<titreSectionl> titre A </titreSectionl> 
<p> para 1 </p> 
<figure href="A.gif"/> 
<titreSection2> titre A.l </titreSection2> 

<p> para 2 </p> 

<p> para 3 </p> 

<figure href="A.l.gif/> 

<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 

<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<figure href="A.2.1.gif"/> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </titreSectionl> 
<figure href="B.gif"/> 
<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.l.l </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 
<figure href="B. 2.gif "/> 

</document> 

initialisation parti el I e de la cle prend alors la forme suivante : 

<xsl : key 

name="lesEnfantsDi rects" 
match="titreSection2 | 
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*[self::p or self : :figure] 
[preceding-sibling: :* 

[nottself : :p)] 

[nottself : :figure)] 

[1] 

[self: :titreSectionl] 

]" 

use="generate-id( preceding-sibl i rig : :titreSectionl[l] )" /> 

Comparez avec initialisation lorsque <p> est le seul element terminal : 

<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :* [not (self : :p)][l][sel f : : titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On peut ameliorer la comparaison en recrivant cette initialisation de la memefacon : 

<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection2 | 
*[self : :p] 

[preceding-sibling: :* 
[not(self : :p)] 
[1] 

[self: :titreSectionl] 

]" 

use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On voit done comment evolue le motif lorsqu'on ajoute des elements terminaux possi- 
bles : globalement, le motif se complexifie, mais sa structure reste tres reguliere, ce qui 
permet done d' envi sager de transformer des textes pi us ri ches que ceux que I ' on a montre 
en exemple. 

Lerestedu programme (I 'etape 2) reste inchangee dans sa structure: leseul endroit delicat 
est I'ecriture des motifs. 

texte.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'xml ' encodings' ISO-8859-1' indent^'yes' /> 
<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl :key name="l esEnfantsDi rects" 
match="titreSectionl" 
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use="generate-id( parent: :document )" /> 



<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection2 | 

*[self::p or self : ifigure] 
[preceding- sibling: :* 
[not(sel f : :p)] 
[not(self : :figure)] 
[1] 

[self: :titreSectionl] 

]" 

use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection3 | 

*[self::p or self : :figure] 
[preceding-sibl ing: :* 
[not(sel f : :p)] 
[not(self : :figure)] 
[1] 

[self: :titreSection2] 

]" 

use="generate-id( preceding-sibl ing: :titreSection2[l] )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="*[self : :p or self : :figure] 
[preceding-sibl ing: :*[ 
nottself : :p)] 
[not(self : :figure)] 
[1] 

[self: :titreSection3] 

]" 

use="generate-id( preceding-sibl ing: :titreSection3[l] )" /> 



<!-- 



Parcours recursif de la hierarchie 



--> 



<xsl : tempi ate match="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl : tempi ate match="document" > 
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<document> 

<xsl : apply-templ ates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 
</document> 
</xsl :template> 

<xsl : tempi ate match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select=" . "/></titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSection2" > 
<Section2> 

<titre><xsl :value-of select=" . "/X/titre> 
<xsl : apply-templ ates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section2> 
</xsl :template> 

<xsl : tempi ate match="titreSection3" > 
<Section3> 

<titre><xsl :value-of select=" . "/X/titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section3> 
</xsl :templ ate> 

<!-- 



Elements terminaux de la hierarchie 



--> 

<xsl :templ ate match="p" > 

<P> 

<xsl :val ue-of select=" . "/> 

</p> 
</xsl :templ ate> 

<xsl :templ ate match="figure" > 
<xsl:copy-of select=" . "/> 
</xsl :template> 



</xsl :stylesheet> 
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Exemple atypique 

Nous allons maintenant voir un exemple beaucoup plus simple, mais un peu atypique, 
afin de verifier que la structure generale d'un programme de reconstruction hierarchique 
tient debout malgre le changement de contexte destabi I isant. 

II s'agit du fichier company. xmi, evoque au debut decette section sur les regroupements : 

company.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<table name="COMPANY"> 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2(l )<br/> 
</table> 

restoredCoinpany.xiiil 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<table name="COMPANY"> 
<field> 

<name>NOACA</name> 

<type>CHAR(6X/type> 
</field> 
<field> 

<name>LSACAK/name> 

<type>VARCHAR2(35X/type> 
</field> 
<field> 

<name>CCPAAK/name> 

<type>NUMBER(4X/type> 
</field> 
<field> 

<name>LAACAK/name> 

<type>VARCHAR2(35X/type> 
</field> 
<field> 

<name>URL</name> 

<type>VARCHAR2(40X/type> 
</field> 
<field> 

<name>STATRAT</name> 

<type>VARCHAR2(l)</type> 
</field> 
</table> 

Ce qui est atypique, ici, c'est que ce sont les elements <tab> qui sont les elements de 
deuxieme niveau, rattaches aux elements <br>, alors qu'ils sont places avant. Bien que 
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cela change un peu de I 'habitude, la structure generale du programme de transformation 
reste i ntacte : 

restoredCompany .xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xml ' encodings' ISO-8859-1' indent='yes' /> 

<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl :key name="l esEnf antsDi rects" 
match="br" 

use="generate-id( parent: :table )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="tab" 

use="generate-id( fol 1 owing-sibl ing: :br[l] )" /> 



<!-- 



Parcours recursif de la hierarchie 



--> 



<xsl :templ ate match="/"> 

<xsl :apply-templates /> 
</xsl :template> 

<xsl : tempi ate match="table" > 
<xsl :copy> 

<xsl :for-each select="attribute: :*"> 

<xsl :copy/> 
</xsl :for-each> 

<xsl : apply-templ ates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 

</xsl :copy> 
</xsl :templ ate> 



<xsl :templ ate match="br" > 
<field> 
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<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 
<type><xsl :value-of select="preceding-sibling: :text( )[l]"/X/type> 
</field> 
</xsl : tempi ate> 

<!-- 



Elements terminaux de la hierarchie 



--> 

<xsl : tempi ate match="tab" > 
<name> 

<xsl : val ue-of sel ect= "normal ize-space (preceding- si bl ing: :text( ) [1] ) "/> 
</name> 
</xsl :templ ate> 



</xsl :stylesheet> 

Le resultat obtenu est le fichier restoredcompany.xmi montre ci-dessus. 

Pattern n° 15 - Generation d'une feuille de style par une autre 
feuille de style 

Motivation 

II y a descas (a priori assez rares) oil I'on tombesur des limitations du langageXSLT lui 
meme : par exemple, le fait que seulement certains attributs soient susceptibles d'accep- 
ter des descripteurs de valeurs differees d'attributs ; ou bien le fait qu'une expression ne 
puisse pas etre construite puis interpret.ee dynamiquement. 

Une solution, lorsque I'on est confronts a cette difficulty consiste a utiliser telle ou telle 
extension proposee par tel ou tel processeur. Mais cette solution, en general, rend le 
programme non portable, ce qui peut ne pas etre acceptable dans certains cas. 

Une autre solution consiste a ecrire une feuille de style qui genere une autre feuille de 
style. 

L'une des difficult.es de la mise en oeuvre d'une feuille de style qui en genere une autre, 
est que la feuille de style va contenir des instructions litterales a produire dans le docu- 
ment resultat ; maisil nefaut pas que le processeur XSLT s'apercoive que ces elements 
XML sont des instructions XSLT, sinon il va tenter de I es executer. C 'est la qu'intervient 
I 'instruction namespace-ai i as, qui permet de produi re dans I e document resultat des ele- 
ments XM L dans un domaine nominal different de celui qu'ils avaient dans la feuille de 
style primitive. 
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Une autre difficulty peutaussi survenir, inattendue : c'est qu'une feuille de style generee, 
c'estbien ; mais une feuille de style generee etexecutee, c'est mieux. 

II est done assez probable qu'en plus de generer la feuille de style, on veuille generer 
un fichier de commande pour lancer I 'execution de cette feuille de style generee avec 
les bons arguments. Se pose des lors le probleme d'etre capable de produire plus 
d'un fichier resultat. C'est en principe infaisable en XSLT 1.0 ; mais le besoin etant 
reel, des extensions existent avec la plupart des processeurs XSLT pour permettre la 
production de plusieurs documents resultat. De son cote, le « Working D raft » 
XSLT 1.1 propose d'ajouter une instruction xsi :document, (et cette proposition a ete 
reprise dans le Working Draft 2.0) dont I'effet sera de permettre la production de 
plusieurs documents. 



L'exempleque nous allons voir est la realisation d'un petit interpreteur X Path : une feuille 
de style qui prend en donnee un fichier XML d'essai, et un fichier XML contenant des 
expressions XPath. La feuille de style a ecrire devra generer une feuille de style capable 
d'evaluer les expressions XPath sur le fichier d'essai. 

Voici tout d'abord ces deux fichiers XML: 

BaseProduits.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<BaseProduits> 

<LesProduits> 



<l_ivre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF'7> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" 

medi a="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 

<Enregistrement ref="marai si" Ref Editeur="LC000280" 




Exemple 



gamme="vi ol edegambe" medi a="CD"> 



<refOeuvres> 

<Ref valeur="marais.folies"/> 
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<Ref val eur="marai s .pieces 1685 "/> 
</refOeuvres> 
<Interpretes> 

<Interprete nom="Jonathan Dunford"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Sylvia Abramowicz"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete nom="Benjamin Perrot"> 

<Role xml :lang="fr"> Theorbe et guitare baroque </Role> 
<Role xml :1 ang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Stephane Fuget"> 

<Role xml :lang="fr"> Clavecin </Role> 
<Role xml :lang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 
<Titre 

xml : 1 ang="f r"> Les Folies d'Espagne et pieces inedites </Titre> 
<Titre 

xml : 1 ang="en"> Folies d'Espagne and unedited music </Titre> 
<Prix val eur="140" monnaie="FF"/> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 

<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamme="lecteurCD" 

marque="HarKar"> 

<refCaracteristiques> 

<Ref val eur="caracHarKarl"/> 
</refCaracteri stiques> 
<Prix val eur="4500" monnaie="FF"/> 
<Prix val eur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<LesOeuvres> 

</LesOeuvres> 

<LesAuteurs> 

</LesAuteurs> 

<LesGammes> 

</LesGammes> 



Patterns de transformation 

Chapitre 9 



<LesMarques> 
</LesMarques> 
<LesCaracteri stiques> 
</LesCaracteri stiques> 
</BaseProduits> 

XPath Express ions .xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Expressions source Fi 1 e="BaseProdui ts .xml "> 

<XPath 
id="l" 

context Node=" En registrement" 

expression="descendant: : Interprete[attribute: :nom = 

'Sylvia Abramowicz']/child: :Role" 

/> 

<XPath 
id="2" 

context Node=" En registrement" 

expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 



<XPath 
id="3" 

context Node="BaseProdui ts" 

expression="descendant: : Li vre[attribute: : ref = 'vernesl']/ 

child:: Prix/attribute: : valeur" 

/> 

<XPath 
id="4" 

context Node=" En registrement" 

expression="descendant: :Titre[attribute: :xml :lang = 'en']" 

/> 

<XPath 
id="5" 

context Node="BaseProdui ts" 

expression="descendant : : Li vre[attribute: : ref = 'vernesl']/ 

child: :Prix[attribute: :monnaie = ' FF' ]/attribute: :valeur" 

/> 

</Expressions> 
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Le but est done d'ecrire une feuille de style xpathinterpretor .xsi telle que le lancement : 

Ligne de commande 

xpath XPathExpressions.xml 

produise le resultat suivant : 

Resultat 

=== id = 1 === 

{ 

-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[attribute: :nom = 

1 Syl via Abramowi cz' ] /child: : Role" 

Basse de viole 
Bass Viol 



} 

=== id = 2 === 
{ 

contextNode="Enregi strement" 
-- expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 
Sylvia Abramowi cz 




contextNode="BaseProdui ts" 

expression="descendant : : Li vre[attribute: : ref = 'vernesl']/ 

child: :Prix/attribute: :valeur" 

40.5 




{ 

-- contextNode="Enregi strement" 

-- expression="descendant: :Titre[attribute: :xml :lang = 'en']" 
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Folies d'Espagne and unedited music 



) 

=== id = 5 === 
{ 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix[attribute: :monnaie = 'FF']/attribute: ivaleur" 

40.5 



} 

La commande de lancement que nous venons de voir ne prend en donnee que le nom 
du fichier X M L contenantles expressions a interpreter (qui lui memefournit le nom du 
fichierXM L a utilisercommejeu d'essai pour lesevaluationsXPath). Cettecommande 
est en fait un script qui lance le processeur XSLT (Saxon, en I 'occurrence), comme 
ceci : 

script Xpath 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 

com. icl .saxon. Stylesheet -o XPathExpressions.xsl 
XPathExpressions.xml . ./XPathlnterpretor.xsl 

call temp. bat 

Dans ce script, seul le nom de fichier en gras est un argument ; tout le reste est constant. 

La feuille de Style XPathlnterpretor.xsl genere la feuille de Style XPathExpres- 

sions.xsi ainsi quelescripttemp.batappelealafin. 

script temp .bat 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 

com. icl .saxon. Stylesheet -o out. memo 
BaseProduits.xml XPathExpressions .xsl 

Dans ce script, seul le nom de fichier en gras est un argument ; tout le reste est constant. 

Quant a la feuille de style generee, la voici, legerement retouchee dans sa presentation 
pourles besoinsdela mise en page: 

XPathExpressions .xsl 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<aaa: stylesheet xmlns:aaa=" http://www.w3.org/1999/XSL/Transform" xmlns:xsl= 
"http://www.w3.org/1999/XSL/Transform" version="1.0"> 
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<aaa:output method="text" encoding="IS0-8859-l"/> 

<-_ ========================= i =========================== _-> 

<aaa:template match="/"> 
= id = 1 === 

<aaa : apply- tempi ates mode="Ml"/> 

= id = 2 === 

<aaa : apply- tempi ates mode="M2"/> 

= id = 3 === 

<aaa : apply- tempi ates mode="M3"/> 

= id = 4 === 

<aa a : apply- tempi ates mode="M4"/> 

= id = 5 === 

<aa a : apply- tempi ates mode="M5"/> 
</aaa :templ ate> 

<-_ ========================= i =========================== _-> 



<-- ========================= 2 =========================== --> 

<aaa:template match="text( ) " mode="Ml"/> 
<aaa:template match="text( ) " mode="M2"/> 
<aaa:template match="text( ) " mode="M3"/> 
<aaa:template match="text( ) " mode="M4"/> 
<aaa:template match="text( )" mode="M5"/> 

<-- ========================= 2 =========================== --> 



<-- ========================= 3 =========================== --> 

<aaa:template match="Enregi strement" mode="Ml"> 

-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[attribute: :nom = 

'Sylvia Abramowicz']/child: :Role" 
<aaa : for- each sel ect= "descendant: : Interprete[ 

attribute: :nom = 'Sylvia Abramowicz' ]/child: : Role"> 
<aaa:value-of select="."/> 

</aaa:for-each> 

</aaa:template> 

<i > 

<aaa:template match="Enregi strement" mode="M2"> 
-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 
<aaa : for- each sel ect= "descendant: : Interprete[ 

positionO = 2] /attribute: :nom"> 

<aaa:value-of select="."/> 
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</aaa:for-each> 

} 

</aaa :templ ate> 

<! > 

<aaa: tempi ate match="BaseProduits" mode="M3"> 

{ 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix/attribute: :valeur" 

<aaa :for-each sel ect=" descendant : : Li vre[ 

attribute: :ref = 'vernesl ' ]/child: : Prix/attribute: :valeur"> 
<aaa:value-of select="."/> 

</aaa:for-each> 

} 

</aaa : tempi ate> 

<i > 

<aaa:template match="Enregistrement" mode="M4"> 

{ 

-- contextNode="Enregi strement" 

-- expression="descendant: :Titre[attribute: :xml :lang = 'en']" 

<aaa :for-each select="descendant: :Titre[attribute: :xml :lang = 'en']"> 
<aaa :val ue-of select=" . "/> 

</aaa:for-each> 

} 

</aaa :templ ate> 

<i > 

<aaa:template match="BaseProduits" mode="M5"> 

{ 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix[attribute: :monnaie = 'FF']/attribute: :valeur" 
<aaa:for-each select="descendant : : Li vre[attribute: : ref = 

'vernesl'] /child: :Prix[ attribute: :monnaie = ' FF' ] /attribute: :valeur"> 
<aaa :val ue-of select="."/> 

</aaa:for-each> 

} 

</aaa : tempi ate> 

<-- ========================= 3 =========================== --> 

</aaa:stylesheet> 
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Comme nous I'avons deja dit, I'un des problemes pour generer une telle feuille de style 
est la presence d' instructions litterales XSLT a emettre dans le document resultat. Par 
exemple, la section 2 ci dessus est generee par le fragment decode suivant : 

<!-- 2 --> 

<xsl :for-each sel ect="XPath"> 
<aaa :templ ate> 

<xsl :attribute name="iriatch">text( )</xsl :attribute> 

<xsl :attribute name="mode">M<xsl :value-of select="@id"/X/xsl :attribute> 
</aaa :templ ate> 
</xsl :for-each> 
<!-- II --> 

On voit que I 'instruction template litterale est dans un domaine nominal prefixe par aaa, 
et different de celui d'XSLT, afin qu'elle ne soit pas prise pour une instruction XSLT a 
executer. 

Ceci implique bien sur de declarer le domaine nominal aaa, comme ceci : 

<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
xmlns:aaa = "http://machin" 
version = "1.0"> 

Le domaine nominal prefixe par aaa n'a aucune importance, n'importe quoi convient 
pourvu que ce ne soit pas "http://www.w3.org/1999/xsL/Transform". Le choix de 
"aaa" peut parartre un peu bizarre, mais on a interet a choisir un prefixe qui s'oppose 
visuellement a "xsi sinon la feuille de style devient inextricable a relire. 

II faut de plus que dans le document resultat, les instructions XSLT (prefixees par aaa), 
soient dans le domaine nominal d'XSLT. C'est la qu'intervient instruction namespace- 
ai i as, qui permet la transposition : 

<xsl :namespace-al i as styl esheet-pref ix="aaa" resul t-pref ix="xsl "/> 

Encore unefois, notons que les domaines nominaux sont references par leur prefixes, et 
done que cette instruction ne demande pas a changer le prefixe dans le resultat, mais a 
changer le domaine nominal associe au prefixe. En clair, on demande que dans I e resultat, 
le domaine nominal associe a aaa ne soit plus soit "http://machin", mais celui qui est 
actuellement associe a xsi . 

Le resultat est visible ci-dessus : la feuille de style generee contient des instructions X SLT 

prefiXeeS par aaa, maiS Ce prefixe est bien Celui de "http://www.w3.org/1999/XSL/Trans- 

f orm", tout est done correct pour que la feuille de style soit reellement executable. 

Cela peut sembler desagreable que cette feuille de style n'utilise pas le prefixe xsi ordi- 
nal re ettraditionnel, mais i I faut bien voir qu'elle est generee, etqu'ellen'estpasdestineea 
etre I ue ou mai ntenue par un etre humai n. 

L'autre probleme a resoudre est la generation d'un document auxiliaire, dans un fichier a 
part. Pour cela nous utilisons I'instruction xsi document, qui ne fait encore partie 
d'aucun standard, mais qui figure dans les Working Drafts 1.1 et 2.0. Cette instruction 
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utilise les memes attribute que xsi : output, a part un attri but supplemental, href, dont la 
valeur donne I'URI du fichier de destination du resultatde I 'instantiation deson modelede 
transformation. Ici, nous I 'utilisons pour generer le contenu du fichiertemp.bat : 

<xsl :document href="temp.bat" method="text"> 

<xsl :text>java -classpath "C:Files.jar;" </xsl:text> 

<xsl :text>com.icl .saxon. Stylesheet -o out. memo </xsl:text> 

<xsl : val ue-of select=" /Express ions /©source Fi 1 e"/> 

<xsl :text> XPathExpressions.xsK/xsl :text> 
</xsl :document> 

Nous avons fait le tour des problemes a resoudre pour obtenir une feuille de style qui en 
genere une autre ; le resultat final est montre ci-dessous : 

XPathlnterpretor.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xmlns:aaa= "http://machin" 

version = "1.1"> <!-- compatibility Saxon 6.5 --> 



<xsl:output method='xml' encodings' ISO-8859-1' indent='yes' /> 
<xsl :namespace-al i as stylesheet-prefix="aaa" resul t-pref ix="xsl "/> 



<xsl :template match='/'> 
<aaa:stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.0"> 

<aaa:output method^'text' encoding="IS0-8859-l"/> 



<xsl :document href="temp.bat" method="text"> 

<xsl :text>java -classpath "C:Files.jar;" </xsl:text> 
<xsl :text>com.icl .saxon. Stylesheet -o out. memo </xsl:text> 
<xsl :value-of select="/Expressions/@sourceFile"/> 
<xsl :text> XPathExpressions.xsK/xsl :text> 

</xsl :document> 

<xsl :apply-templates/> 
</aaa:stylesheet> 
</xsl :templ ate> 



<xsl :template match='Expressions'> 
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<!-- 1 --> 
<aaa : tempi ate> 

<xsl rattribute name="match">/</xsl :attribute> 
<xsl :for-each select="XPath"> 
=== id = <xsl :value-of select="@id"/> === 
<aaa : apply- tempi ates> 

<xsl :attribute name="mode">M<xsl :val ue-of select="@id"/> 
</xsl :attribute> 
</aaa : apply- tempi ates> 
</xsl :for-each> 
</aaa :templ ate> 
<!-- II --> 

<!-- 2 --> 

<xsl :for-each sel ect="XPath"> 
<aaa :templ ate> 

<xsl :attribute name="match">text( )</xsl :attribute> 
<xsl rattribute name="mode">M<xsl :value-of select="@id"/> 
</xsl :attribute> 
</aaa :templ ate> 
</xsl : for-each> 
<!-- II --> 

<!-- 3 --> 

<xsl :for-each sel ect="XPath"> 

<aaa :templ ate> 

<xsl :attribute name="match"> 

<xsl :value-of sel ect="@contextNode"/> 
</xsl :attribute> 

<xsl rattribute name="mode">M<xsl :value-of select="@id"/> 
</xsl :attribute> 

{ 

-- contextNode="<xsl :val ue-of select="@contextNode"/>" 
-- expression="<xsl :val ue-of select="@expression"/>" 
<aaa:for-each> 

<xsl :attribute name="sel ecf'Xxsl :value-of select="@expression"/> 

</xsl :attribute> 

<aaa:value-of> 

<xsl rattribute name="select">.</xsl :attribute> 
</aaa :val ue-of> 

</aaa :for-each> 

} 

</aaa : tempi ate> 
</xsl : for-each> 
<!-- /3 --> 

</xsl :templ ate> 

</xsl :stylesheet> 
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Pattern n° 16- Generation de pages HTML dynamiques 

Motivation 

Avec I'avenement des applications Internet, il afallu mettreau poi nt des systemes capa- 
bles degenerer des pages HTM L dynamiques. En effet, I'envoi de simples pages HTM L 
statiques est en general tres insuffisant pour une application qui doit extraire ou calculer 
des informations (typiquement en provenance d'une base de donnees) et les presenter a 
I'internaute. La generation de pages dynamiques, en general, vient en complement des 
pages statiques, caril estbien rare que tout soitdynami que dans une page: il yatres sou- 
vent un fond statique, sur lequel on plaque les donnees dynamiques. Ce pattern va mon- 
trer comment faire pour construire une page dynamique a partir d'un fond statique et de 
donnees auxiliaires. 



Remarque 

Nous avons deja vu un exemple de generation de pages dynamiques, au tout debut, pourdonnerun avant-gout 
du langageXSLT (voirLIn avant-gotitdXSLT, page 9). Mais cette page dynamique etait realisee avec une feuille 
de style simplified (Simplified Stylesheet), dontles possibility en matierede transformation etde traitementsont 
tres limitees. Ici nous allons voir I'equivalent d'une fa?on plus evoluee, permettant par exemple d'envisagerde la 
traduction « a la volee » (voir Pattern n '18 - Localisation d line application, page 533). 

La premiere chose a faire est de definir le fond statique, car c'estlui qui va piloter I'appel 
des donnees dynamiques aux bons endroits. L e pi us simple est ici de prendre un exemple. 
Nous allons supposer que nous voulons afficher une page d'annonce du prochain concert ; 
lefond statique aura I 'allure suivante : 

fond.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<title>Les Concerts Anacreon</titl e> 
</head> 
<body> 

<H1 al ign="center"> Concert le <dateConcert/> </Hl> 

<H4 al ign="center"> <1 ieuConcert/> </H4> 

<H2 al ign="center"> Ensemble <ensemble/> </H2> 

<listeMusiciens> 
<P> 

<musicien/>, <instrument/> 

</p> 

</l isteMusiciens> 



<H3> 

Oeuvres de <1 i steCompositeurs/> 
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</H3> 

</body> 
</html> 

Le fond est done constitue majoritairement de balises HTM L ; cependant, la ou on a 
besoin de valeurs dynamiques, un element non HTM L est la pour redamer une valeur 

(par exemple, <dateConcert/>). 

U ne des difficulty pouvant se apparaitre dans un tel contexte, e'est la presence de don- 
nees a repeter un certain nombre de fois, nombre qui est naturellement inconnu a cet 
endroit. Nous avons illustre ceci avec la listedes musiciens a faire figurer : on nesait pas 
combien il y en a, maiscequ'on sait, e'estquechaque musicien doitetrementionne avec 
son nom et son instrument. On doit done ici se contenter de definir comment doit appa- 
raitre une des lignes d'affichage de musicien : 

<p> unNomDeMusicien, leNomDeSonlnstrument </p> 

C'estcequi estexprime par le bloc : 

<listeMusiciens> 
<P> 

<musicien/>, <instrument/> 

</p> 

</listeMusiciens> 

Avant devoir comment mettreau point une transformation XSLT adequate, remarquons 
tout de suite que cette facon de proceder est conforme a I'idee generale de la separation 
des competences que I'on essaye toujours d'obtenir dans la mise au point d'une applica- 
tion Internet; ici un graphiste sans competence particul iere en programmation XSLT 
pourra parfaitementecrire lefond statique, avec les appels de donnees dynamiques. 

Cefond statique va done appeler des donnees dynamiques ; dans la pratique, avec un serveur 
d'application commeWeb Logic deBEA ou d'autresdu meme genre, il estassez peu proba- 
ble que ces donnees dynamiques soient placees dynamiquement dans un fichier. En fait, les 
donnees sont en memoire sous forme d'objets, et le processus va consister a construire un 
arbre DOM (Document Object M odel) avec ces objets. 

Note 

Un arbre DOM n'estrien d'autre qu'une implementation particuliere de I'arbre XML d'un documentXML. 

Une fois I'arbre DOM construit, il est strictement equivalent a un document XM L, du 
point devuedu processeur XSLT. Le serveur d'application (la servlet en cours) va done 
activer le thread du processeur XSLT resident (charge avec les autres servlets par le ser- 
veur d'application) en lui transmettantl'URI du fichier statique a traiterainsi que I'arbre 
DOM des donnees dynamiques, ce qui est faisable avec I'API TrAX (Transformation 
API forXM L), reprise dans J AX P deSUN (Java A PI for XML). On seretrouvealors, du 
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point devueXSLT, avec deux sources XML, une source principale, et une source auxi- 
liaire accessible par un appel a la fonction documentc ). 

Mais pour simplifier, nous supposerons ici que nous avons deux sources XML sous 
forme de fichiers, le seul probleme etant de realiser la transformation qui va donner la 
pagedynamique. 

Le fichier auxiliaire des donnees est le suivant : 



Annonce.xml 

<?xml version="1.0" encoding="UTF-16"?> 



<Annonce> 



<Date> 

<Jour>Jeudi</Jour> 

<Quantieme>17</Quantieme> 

<Mois>janvier</Moi s> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</I_ieu> 
<Ensembl e>A deux violes esgales</Ensemble> 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 



<Interprete> 

<Nom> Benjamin Perrot </Nom> 
<Instrument>Theorbe</Instrument> 

</Interprete> 



<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Cl a vecin</ Inst rumen t> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



</Annonce> 
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Realisation 

Lefichier principal est le fichier statique, caril est fait pour piloter I'appel desdonnees 
dynamiques. Lefichier resultat (la pagedynamique) est I a page statique, dans laquelleles 
appels de valeurs sont remplaces par leur valeur : nous sommes done dans un cas typique 
d'utilisation du pattern « copie non conforme ». 

L'idee de base, ici, est que par defaut, les elements doivent etre recopies sans modifica- 
tion ; nous al Ions done adopter la regie avec priori te basse vue a la section Copie conforme 
gene'rique, page 444 : 

<xsl : tempi ate match="chi Id: :node( ) | attribute: :*" priori ty="- 10" > 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl :apply-templates select="child: :node( )" /> 
</xsl :copy> 
</xsl : tempi ate> 

Cette regie est a contredire uniquement pour les elements qui constituent un appel de 
valeur dynamique. Dans notre cas, cela concerne les elements <dateConcert/>, <iieu- 

Concert/>, <ensembl e/>, <1 i steMusi ci ens>, <musi ci en/>, <i nstrument/>, <listeCom- 

positeurs/>. II va done fal loir une regie spec ifique pour chacun d'eux. 

LeS elements <dateConcert/>, <1 i euConcert/>, <ensemble/>, et <1 i steCompositeurs/> 

ne posent pas de probleme parti culier et reposent tous sur le meme model e ; leur traitement 
necessite d'avoir acces a la source XML secondaire : 

<xsl :param name="annonceFileRef">Annonce.xml</xsl :param> 

<xsl :variable name="Annonce" select="document($annonceFileRef )/Annonce"/> 

<xsl :template match='dateConcert'> 

<xsl :val ue-of sel ect="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Heure" /> 
</xsl : tempi ate> 



<xsl :template match='lieuConcert'> 

<xsl : val ue-of select="$Annonce/Lieu" /> 
</xsl :templ ate> 
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<xsl : tempi ate match='ensemble'> 

<xsl :value-of select="$Annonce/Ensemble" /> 
</xsl :templ ate> 

<xsl :template match='listeCoiripositeurs'> 

<xs! :val ue-of select="$Annonce/Compositeurs" /> 
</xsl :templ ate> 

L'element <i isteMusiciens> est un peu plus complique a mettre au point. II faut copier 
son model ede transformation, asavoir : 

<p> 

<musicien/>, <instrument/> 

</p> 

autant de fois que I'on va trouver l'element <interprete> dans le document 
Annonce.xmi, puisqu'il faudra bien qu'il y ait autant de <p> ... </p> quede musiciens. 
Done la regie va commencer par un <xsi :for-each> pour traiter I e node-set des <inter- 
prete> du document auxiliaire : 

<xsl :template match='listeMusiciens'> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" sel ect=" . "/> 

</xsl :for-each> 
</xsl :templ ate> 

La variable current-interprete conserve le noeud courant, e'est-a-dire l'<inter- 
prete> courant, car I'experience montre qu'on a frequemment besoin de se reperer 
par rapport au noeud courant dans une instruction <xsi :for-each> ; et meme si cette 
variable n'est pas indispensable, el I e permet de mieux s'y retrouver pour construire 
la regie. 

Mais n'oublions pas que la regie doit instancier n fois le modele de transformation 
indique plus haut ; I'unede ces instanciations peut sefaire par un <xsi :copy>, a condi- 
tion que le noeud contextesoit place sur l'element <p>. Or la oil il y a les points de sus- 
pension, dans la regie ci-dessus, le noeud contexte n'est pas place sur <p>, parce que 
I ' i nstructi on <xsi : for-each> deplace le noeud contexte sur le noeud en cours. Le noeud 
contexte, a cet endroit, est done place dans I'arbreX M L du document auxiliaire, sur le 
noeud <interprete> courant, celui qui precisement, est reference par la variable 

current-interprete. 

Pour remettre le noeud contexte sur l'element <p> afin de permettre la copie, il n'y a 
qu'une seule solution : utiliser a nouveau un <xsi :for-each>, puisque e'est la seule ins- 
truction capable de deplacer le noeud contexte. Pour cela, il faut sauvegarder le noeud 
courant a I 'entree de la regie (1), puis selectionner son enfant direct <p> (2) : 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="current-listeMusiciens" select="."/> <!-- (1) --> 
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<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 
<xsl :for-each select="$current-listeMusiciens/p"> <!-- (2) --> 
<xsl :copy> 

</xsl :copy> 
</xsl : for-each> 
</xsl :for-each> 
</xsl : tempi ate> 

Nous avons maintenant une regie presque complete ; I 'instruction <xsi :copy> va copier 
I 'element <p>, mais les elements enfants de <p> sont des elements non HTM L, qui doi- 
vent faire I'objet d'une regie specifique, du meme genre que celle de <iieuConcert/>, 
par exemple. II est done necessaire d' avoir un <xsi :appiy-tempiates> la ou setrouvent 
les points de suspension, ci-dessus : 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 
<xsl :for-each sel ect="$current-l isteMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates/> 
</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl : tempi ate> 

<xsl :template match='musicien'> 

<xsl :value-of select^"???" /> 
</xsl : tempi ate> 

L'idee est bonne, car apres avoir copie I'element <p>, I 'instruction <xsi :appiy-tempiates> 
va effectivement selectionner ses enfants directs (e'est-a-dire I'element <musicien/>, le 
texte ' , "' (virgule, espace, guillement) et I'element <instrument/>, (plus eventuelle- 
ment des noeuds texte ne contenant que des espaces blancs sans interet), et done la regie 

<xsl : tempi ate match='musi cien '> va etre SeleCtionnee. 

Le probleme, e'est que dans cette regie, on est cense instancier le nom d'un musicien ; 
malheureusement, le musicien en question, on I'a perdu. II etait dans la variable 
current-interprete qui est desormais inaccessible. Inaccessible? Pas tout a fait : I'ins- 
truction <xsi :appiy-tempiates> autorise la transmission d'arguments. C'est assez rare 
d'avoir a utiliser cette possibility, mais la, c'est le moment ou jamais : 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 
<xsl :for-each select="$current-l isteMusiciens/p"> 
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<xsl :Copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate match='musicien'> 

<xsl:param name="interprete"/> 

<xsl :val ue-of select="$interprete/Nom" /> 
</xsl :templ ate> 

Du coup, la regie specifique pour l'<instrument/> va pouvoir etre faite sur le meme 
modele, puisque die sera selectionne elleaussi par le meme <xsi :appiy-tempiates> : 

<xsl :template match='instrument'> 

|<xsl:param name="interprete"/> 
<xsl : val ue-of select="$interprete/Instrument" /> 
</xsl :templ ate> 

M ais que va-t-il advenir du noeud text contenant ", " ? Le processeur va chercher 
une regie a lui appliquer, ne va pas en trouver, et va done appliquer la regie par defaut 
(voir Regies par defaut pour un nceud de type text ou attribute, page 120) pour les 
nceuds text. Or cette regie par defaut ne prend pas de parametre en donnee, alors que 
instruction <xsi :appiy-tempiates> responsable de I'activation de cette regie en a 
transmis un. Ceci n'est pas une erreur (voir la section Seimantique, page 234), et heu- 
reusement, parce que sinon, cela compliquerait diablement les choses s'il fall ait 
eviter cette situation. 

On peut done maintenant rassembler les morceaux pour obtenir le programme complet : 

AnnonceConcert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transforin" 
version="1.0"> 

<xsl:output method='html ' encodings ISO-8859-1' /> 

<xsl :param name="annonceFi 1 eRef ">Annonce.xml</xsl :param> 

<xsl :variable name="Annonce" select="document($annonceFileRef )/Annonce"/> 

<xsl : tempi ate match=" child: :node( ) | attribute: :*" priori ty="-10"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl :apply-templates select="child: :node()"/> 
</xsl :copy> 
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</xsl :templ ate> 

<xsl :template match='dateConcert'> 

<xsl :val ue-of sel ect="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Heure" /> 
</xsl :templ ate> 

<xsl :template match='lieuConcert'> 

<xsl :val ue-of sel ect="$Annonce/Lieu" /> 
</xsl :templ ate> 

<xsl : tempi ate match='enseirible'> 

<xsl :val ue-of sel ect="$Annonce/Ensembl e" /> 
</xsl :templ ate> 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each sel ect="$current-l i steMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl : for-each> 
</xsl :templ ate> 

<xsl : tempi ate match='inusicien'> 
<xsl:param name="interprete"/> 
<xsl :value-of select="$interprete/Nom" /> 
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</xsl :templ ate> 

<xsl :template match='instrument'> 

<xsl:param name="interprete"/> 

<xsl :value-of select="$interprete/Instrument" /> 
</xsl :templ ate> 

<xsl :template match='listeCoiTipositeurs'> 

<xsl :val ue-of select="$Annonce/Compositeurs" /> 
</xsl :template> 

</xsl :stylesheet> 

Etvoici le resultat obtenu : 

Annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<title>Les Concerts Anacréon</title> 



<body> 

<H1 align="center"> Concert le Jeudi 17 janvier 2002 20H30 </Hl> 

<H4 al ign="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 




</head> 



Jonathan Dunford 



Basse de viole 



</p> 
<P> 



Sylvia Abramowicz , Basse de viole 



</p> 
<P> 



Benjamin Perrot , Théorbe 



</p> 
<P> 



Freddy Eichelberger , Clavecin 



</p> 
<H3> 



Oeuvres de 



M. Marais, D. Castello, F. Rognoni 



</H3> 
</body> 
</html> 



Dans le fichier ci-dessus, les lignes blanches ontete enlevees pour gagner de la place ; le 
rendu HTML est montre a la figure 9-4. 
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Figure 9-4 

Aspect de la page 
dynamique obtenue. 
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J 


Chape lie des Ursules 




Ensemble A deux violes esgales 




J UIlaL-ll<lIl Ly 11 U 1 , I. 1 a . - . - r . L**> 




Sylvia Abramowicz , Basse de viole 




Benjamin Perrot, The orb e 




Freddy Eichelberger , Clavecin 




Oeuvres de M. Marais, D. Castello, F. Rognoni 


J 


Q T ermine ^ Poste de travail 





Conclusion 

Le pattern que nous venons de voir permet de generer des pages HTML dynamiques, 
mais il ne faut pas croire que ce soit la seule application possible. Par exemple, sur le 
meme principe, on peut construire un generateur de classes Java, qui utilise des fonds 
statiques de ce style: 

Measure.tmpl 

<?xml version="1.0"?> 

<templ ate> 

// 

// 

// stored Measure <MeasureName/> 
// 

protected <MeasureType/> <MeasureName/>; 

public final <MeasureType/> get<MeasureNamewithCapital />( ) { 
return <MeasureName/>; 

} 



public final void set<MeasureNamewithCapital/>( 

<MeasureType/> <aMeasureName/> ){ 
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super. setAttri bute( "<MeasureName/>" , <aMeasureName/>. toString( ) ) ; 
<MeasureName/> = <aMeasureName/>; 

Assertion. ensure( get<MeasureNamewithCapital/>( ) == <aMeasureName/> ); 

} 

</templ ate> 

L e generateur construit une classej ava en assemblant un certain nombre de petites pieces 
de puzzle comme eel le montree ci-dessus (I'element <tempiate>), ou les elements XM L 
sontdes appels devaleurs, exactement comme dans lefichier fond.xmi utilise en exem- 
ple pour la generation de pages HTM L dynamiques. Les « valeurs » sont obtenues dans 
des fichiers XML source auxiliaires qui derivent des differentes phases anterieures de 
modelisation, comme on peut en avoir un apercu dans I'extrait ci-dessous : 

Entity .xml 

<Entity name="Contract" persi stance="simpl e" IHMconnected="true"> 

<MeasureRef id="beginningDate" /> 

<MeasureRef id="contractNbr" i sPartOf Key="yes" /> 

<MeasureRef id="type" /> 
</Entity> 

<Entity name="Country" persistance="simple" > 

<MeasureRef id="countryCode" i sPartOf Key="yes" /> 

<MeasureRef id="zoneEuro" /> 
</Entity> 

<Measure name="contractNbr" type="String" access="stored" /> 
<Measure name="type" type="String" access="stored" /> 
<Measure name="coefficient" type="String" access="stored" /> 
<Measure name="countryCode" type="String" access="stored" /> 
<Measure name="zoneEuro" type="Bool ean" access="stored" /> 
<Measure name="beginningDate" type="BusinessDate" access="stored" /> 



Pattern n° 17 - Generation de pages HTML dynamiques 
pour un portail 

Le pattern que nous al Ions voir ici reprend le precedent, en le modifiant legerement pour 
montrer comment generer une page dynamique pour un portail. Ce qui va changer, e'est 
lefait qu'il ne va plusy avoir un seul fichier XML auxiliairede description des donnees, 
mais plusieurs. En effet, dansun portail, il y a multituded'informations rassemblees dans 
une seule page, et ces informations ne proviennent pas toutes du meme fichier, evidem- 
ment. 1 1 y a done de nombreuses sources XML a exploiter et a syntheti ser dans la genera- 
tion dynamique de la page. Pour les besoins de I'exemple, nous aurons deux sources 
XML, et ce n'est plus le programme XSLT qui connait d'avance le nom des fichiers 
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XML a consulter, mais c'est le fond statique qui I'indique, avec des balises modifiees 
commececi : 

fond.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<title>Les Concerts Anacreon</titl e> 
</head> 
<body> 

<H1 align="center"> Concert le <dateConcert href="Annonce.xml "/> </Hl> 

<H4 align="center"> <lieuConcert href="Annonce.xml "/> </H4> 

<H2 align="center"> Ensemble <ensemble href="Annonce.xml "/> </H2> 

<1 isteMusiciens href ="Annonce. xml "> 
<P> 

<musicien/>, <instrument/> 

</p> 

</listeMusiciens> 
<H3> 

Oeuvres de <1 i steCompositeurs href="Annonce.xml "/> 
</H3> 



<P> 

Reservations : -(reservations href="Reservations .xml "/> 

</p> 

</body> 
</html> 

Ce fond contient desormais des balises qui font reference aux fichiers XML a exploiter 
pour aller chercher les valeurs a placer dynamiquement. Le fichier Annonce.xmi reste 
identique a cequ'il etait a la section precedente (voir Pattern n° 16 -Generation de pages 
HTML dynamiques, page518). Le fichier Reservations. xmi contient les informations 
suivantes : 

Reservations .xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Reservations> 

<Reservation> 

<Lieu>Chapelle des Ursules</Lieu> 

<Tel>02 41 11 12 13 14</Tel> 
</Reservation> 
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<Reservation> 

<l_ieu>Anacreon</l_ieu> 
<Tel>02 41 99 97 98 99</Tel> 

</Reservation> 



<Reservation> 

<Lieu>FNAK</Lieu> 

<Tel>02 41 00 97 98 99</Tel> 
</Reservation> 



</Reservations> 



La consequence est que le programme XSLT ne doit plus creer unefois pour toutes une 
variable contenant la source auxiliaire, mais doit pouvoir changer de source eventuel- 
lementachaqueregle : 

AnnonceConcert.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transforin" 
version="1.0"> 



<xsl:output method='html ' encoding='IS0-8859-l' /> 

<xsl : tempi ate mat ch=" child: :node( ) | attribute: :*" priority="-10"> 
<xsl :copy> 

<xsl : apply-templ ates select="attribute: :*" /> 
<xsl :apply-templates select="child: :node()"/> 
</xsl :copy> 
</xsl :template> 



<xsl :template match='dateConcert'> 



<xsl :variable name="Annonce" sel ect="document(@href )/Annonce"/> 



<xsl :value-of select="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 



<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Heure" /> 



</xsl :templ ate> 
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<xsl :template match='lieuConcert'> 

<xsl :variable name="Annonce" sel ect="document(@href )/Annonce"/> 

<xsl :val ue-of sel ect="$Annonce/Lieu" /> 
</xsl :templ ate> 

<xsl : tempi ate match='enseinble'> 

<xsl :variable name="Annonce" sel ect="document(@href )/Annonce"/> 

<xsl :val ue-of sel ect="$Annonce/Ensembl e" /> 
</xsl :templ ate> 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="Annonce" sel ect="document(@href )/Annonce"/> 
<xsl :variable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each sel ect="$current-l i steMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate match='inusicien'> 

<xsl:param name="interprete"/> 

<xsl :val ue-of select="$interprete/Nom" /> 
</xsl :templ ate> 

<xsl :template match=' instruments 

<xsl:param name="interprete"/> 

<xsl :val ue-of select="$interprete/Instrument" /> 
</xsl :templ ate> 

<xsl :template match='listeCompositeurs'> 

<xsl :variable name="Annonce" sel ect="document(@href )/Annonce"/> 
<xsl :val ue-of select="$Annonce/Compositeurs" /> 

</xsl :templ ate> 

<xsl :template match='reservations'> 
<xsl :variable name="reservations" 

sel ect= " document (@href )/ Reservations "/> 
<xsl :for-each select="$reservations/Reservation"> 
<br/> 

<xsl :for-each select="*"> 

<xsl :val ue-of select^"." /> 

<xsl:if test="position( ) != last()"> 
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<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 

</xsl :stylesheet> 

Commeon peutlevoir, leschangementsapportes sonttresmodestes : il suffit de supprimer 
la declaration de variable globale, et de placer une declaration equivalente dans chaque 
regie dont le motif concordeavec une balise susceptible d'avoir un attri but href. 

La regie pour traiter les reservations ne prejuge pas du contenu du fichier Reserva- 
tions, xmi : la seule chose qui soit demandee, c'est qu'il y ait un ou plusieurs elements 
<Reservation>, et cela suffit pour que le contenu deces elements soit affiche. 

Voici le resultat obtenu (sans les lignes blanches inutiles) : 

AnnonceConcert.html 

<html> 

<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title>Les Concerts Anacréon</title> 
</head> 
<body> 

<H1 align="center"> Concert le Jeudi 17 janvier 2002 20H30 </Hl> 

<H4 al ign="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 

Jonathan Dunford , Basse de viole 

</p> 
<P> 

Sylvia Abramowicz , Basse de viole 

</p> 
<P> 

Benjamin Perrot , Théorbe 

</p> 
<P> 

Freddy Eichelberger , Clavecin 

</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
<P> 

Réservations : <br>Chapelle des Ursules, 02 41 11 12 13 
14<br>Anacréon, 02 41 99 97 98 99<br>FNAK, 02 41 00 97 98 99 

</p> 
</body> 
</html> 
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Pattern n° 18- Localisation d une application 

Motivation 

Un produitetantde pi us en plussouventconcu pour etre vendu danslemondeentier, il faut 
eventuellement, suivant sa nature, le « local iser » pour pouvoir le vendre. La localisation 
consiste a adapter le produit aux us et coutumes du pays vise, I'aspect le plus evident de 
cette adaptation portantsur la traduction des textes a presenter a I'utilisateur final. 

Un cas parti culier extremement frequent de localisation est eel le qui consiste a adapter 
une application Internet a la langue (voire a la legislation ...) du pays de I'utilisateur iden- 
tifie. LorsqueXSLT est utilise pour generer des pages HTML dynamiques (comme dans 
le pattern que I'on vient de voir), il est souhaitable de realiser la localisation simultane- 
ment. N ous al I ons done reprendre exactement le meme exemple que precedemment, et le 
meme pattern degeneration dynamiquede pages HTM L, en lui associantun dictionnaire 
de traduction en fonction d'une langue cible. 

Realisation 

Le principe est le meme que pour I e pattern de generation de pages HTML dynamiques ; 
nous al I ons done reprendre le fichier fond.xmi tel qu'il eta it a la section Pattern n° 16 - 
Generation de pages HTM L dynamiques, page 518, mais en le modifiant pour remplacer 
touttexte litteral par un appel de valeur permettant la traduction : 

fond.xmi 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<title>Les Concerts Anacreon</title> 
</head> 
<body> 

<H1 align="center"> <concertLe/> <dateConcert/> </Hl> 
<H4 align="center"> <lieuConcert/> </H4> 
<H2 align="center"> <ensemble/> </H2> 

<listeMusiciens> 
<P> 

<musicien/>, <instrument/> 

</p> 

</listeMusiciens> 
<H3> 

<oeuvresDe/> 
<1 isteCompositeurs/> 
</H3> 



</body> 
</html> 
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Latraduction proprementdite a dejaetevue (voir la section Exemple, page 223) ; il suffit 
done de reprendre cette technique de traduction et de I'associer au pattern « Generation 
de pages HTM L dynamiques ». Voici le fichier source auxiliaire : 

Annonce.xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Annonce> 

<Date> 

<Jour id="jeu"/> 

<Quantieme>17</Quantieme> 

<Mois id="jnv"/> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble>A deux violes esgales</Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

<Instrument id="clv"/> 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



</Annonce> 
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L a traduction est basee sur un dictionnaire, qui doit comporter un equivalent dans chaque 
langue des appels de valeurs presents dans lefond statique : 

Dictionnaire. xml 



<?xml version="1.0" encoding="UTF-16"?> 

<Dictionnaire> 

<mot id="bvl"> 

<traduction 1 ang="fr">Basse de viole</traduction> 
traduction 1 ang="en">Bass viol</traduction> 

</mot> 

<mot id="vdg"> 

<traduction lang="fr">Viole de gambe</traduction> 
traduction lang="en">Viola da gamba</traduction> 

</mot> 



<mot id="lth"> 
<traduction 
<traduction 

</mot> 

<mot id="clv"> 
<traduction 
<traduction 

</mot> 

<mot id="flt"> 
<traduction 
<traduction 

</mot> 

<mot id="thb"> 
<traduction 
<traduction 

</mot> 

<mot id="lun"> 
<traduction 
<traduction 

</mot> 



I ang="f r">Luth</traduction> 
I ang="en">Lute</traduction> 



I ang="f r">Cl avecin</traduction> 
I ang="en">Harpsichord</traduction> 



I ang="f r">Fl ute a bec</traduction> 
I ang="en">Recorder</traduction> 



I ang="f r">Theorbe</traduction> 
I ang="en">Theorbo</traduction> 



I ang="f r">l undi</traduction> 
I ang="en">monday</traduction> 



<!-- etc. (les autres jours de la semaine) --> 

<mot id="jeu"> 

<traduction 1 ang="f r">jeudi</traduction> 

traduction 1 ang="en">thursday</traduction> 

</mot> 
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<mot id="jnv"> 

<traduction 1 ang="f r">janvier</traduction> 

<traduction 1 ang="en">january</traduction> 
</mot> 

<!-- etc. (les autres mois de l'annee) --> 

<mot id="dcb"> 

traduction 1 ang="f r">decembre</traduction> 

<traduction 1 ang="en">december</traduction> 
</mot> 

<mot id="concertl_e"> 

<traduction 1 ang="f r">Concert le</traduction> 

<traduction 1 ang="en">Concert on</traduction> 
</mot> 

<mot id="oeuvresDe"> 

<traduction 1 ang="f r">0euvres de</traduction> 

<traduction 1 ang="en">Works by</traduction> 
</mot> 

<mot id="MarqueQuantieme"> 

<traduction 1 ang="f r"X/traduction> 

traduction 1 ang="en">th</traduction> 
</mot> 

</Dictionnaire> 

Le programme XSLT est une adaptation du programme precedent, danslequel on integre 
des appels a un modele nomme de traduction : 

Annonce.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='html ' encoding='IS0-8859-l' /> 

<xsl :param name="langueCible">fr</xsl :param> 

<xsl :param name="dicoFileRef">dictionnaire.xml</xsl :param> 

<xsl :param name="annonceFi 1 eRef ">Annonce.xml</xsl :param> 

<xsl variable name="Dictionnai re" 

sel ect=" document ( $di coFi 1 eRef ) /Diet ionna ire" /> 
<xsl :variable name="Annonce" 

sel ect=" document ($annonceFi 1 eRef )/Annonce"/> 
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<xsl :template name="instancier-traduction"> 
<xsl:param name="motId"/> 



<xsl :variable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$mot Id] " /> 



<xsl :variable 

name="saTraduction" 

select="$motTrouve7traduction[@l ang=$l angueCibl e] " /> 



<xsl :val ue-of sel ect="$saTraduction" /> 
</xsl :templ ate> 



<xsl : tempi ate match="chi Id: :node( ) | attribute: :*" priori ty="- 10" > 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl :apply-templates select="child: :node( )"/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match='concertLe'> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" sel ect=" 'concertLe' " /> 

</xsl : call -tempi ate> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 



<xsl :template name='instancier-Date'> 



<xsl:param name="Jour"/> 
<xsl:param name="Quantieme"/> 
<xsl:param name="Mois"/> 
<xsl:param name="Annee"/> 



<xsl :choose> 

<xsl :when test="$langueCible = 'fr'"> 

<xsl :val ue-of sel ect="$Jour"/> 

<xsl:text> </xsl:text> 

<xsl :value-of select="$Quantieme"/> 

<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Mois"/> 

<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annee"/> 
</xsl :when> 



<xsl :when test="$langueCible = 'en'"> 
<xsl :val ue-of sel ect="$Jour"/> 
<xsl:text>, the </xsl:text> 
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<xsl :value-of select="$Quantieme"/> 
<xsl:text>th of </xsl:text> 
<xsl :value-of select="$Mois"/> 
<xsl:text>, </xsl:text> 
<xsl :value-of select="$Annee"/> 
</xsl :when> 
</xsl :choose> 



</xsl :templ ate> 



<xsl : template match='dateConcert'> 

<xsl :call -template name="instancier-Date"> 

<xsl :with-param name="Jour"> 

<xsl real 1 -tempi ate name="instancier- traduction'^ 
<xsl :with-param name="motId" 

sel ect="$Annonce/Date/Jour/@id" /> 

</xsl :call-template> 
</xsl :with-param> 

<xsl :with-param name="Quantieme"> 

<xsl :value-of select="$Annonce/Date/Quantieme" /> 
</xsl :with-param> 

<xsl :with-param name="Mois"> 

<xsl real 1 -tempi ate name="instancier-traduction"> 
<xsl :with-param name="motId" 

sel ect="$Annonce/Date/Moi s/@id" /> 

</xsl :call-template> 
</xsl :with-param> 

<xsl :with-param name="Annee"> 

<xsl :val ue-of select="$Annonce/Date/Annee" /> 
</xsl :with-param> 

</xsl :call -template> 

<xsl:text> </xsl:text> 

<xsl :value-of select="$Annonce/Date/Heure" /> 



</xsl :templ ate> 

<xsl :template match='lieuConcert'> 

<xsl :value-of select="$Annonce/Lieu" /> 
</xsl :templ ate> 

<xsl :templ ate match='ensemble'> 
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<xsl : val ue-of sel ect="$Annonce/Ensembl e" /> 
</xsl :templ ate> 

<xsl :template match='listeMusiciens'> 

<xsl :variable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each sel ect="$current-l i steMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl : for-each> 
</xsl :templ ate> 

<xsl : tempi ate match='musicien'> 

<xsl:param name="interprete"/> 

<xsl :val ue-of select="$interprete" /> 
</xsl :templ ate> 

<xsl :template match=' instruments 
<xsl:param name="interprete"/> 
<xsl:text> </xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" select="$interprete/Instrument/@id" /> 
</xsl :call-template> 
</xsl :templ ate> 



<xsl :template match='oeuvresDe'> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" sel ect=" 'oeuvresDe' " /> 

</xsl :cal 1 -tempi ate> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match='listeCompositeurs'> 

<xsl : val ue-of select="$Annonce/Compositeurs" /> 
</xsl :templ ate> 



</xsl :stylesheet> 
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Le resultat obtenu avec le parametre ianguecibie=en est montre a la figure 9-5. 

Figure 9-5 

Aspect de la page 
dynamique traduite 
en anglais. 

january, 2002 - 20H30 

Chapelle des Ursules 

A deux violes esgales 

Jonathan Dunford , Bass viol 

Sylvia Abramowicz , Bass viol 

B enj amin P errot , The orb o 

Freddy Eichelberger , Harpsichord 

Works by M. Marais, D. Castello, F. Rognoni 

d 

^2 T ermine ^31 Poste de travail 



3l Les Concerts Anacreon - Microsoft Internet Explorer 



Fichief Edition Affichage Favoiis Outils 



Liens 



Concert on thursday, the 17th of 



Pattern n° 19 - Construction dynamique de Pagencement 
d un tableau HTML 

Nous avons deja vu le probleme de la generation dynamique d'une page HTML, qui 
consiste a creer dynamiquement un contenu, ensuite plaque sur un fond HTML plus 
ou moins statique (voir Pattern n°16 - Generation de pages HTML dynamiques, 
page 518). 

Le pattern que nous allons voir maintenant va beaucoup plus loin : il permet de generer 
dynamiquement non seulement le contenu, mais aussi la disposition de ce contenu dans 
la page. 



Note 

L'idee de ce pattern m'est venue en lisantune intervention de J eni Tennison (tres active sur la mailing listXSLT 
de www.mulberrytech.com/xsl/xsl-list/). On pourra la retrouveren faisantune recherche de «The evaluate 
function » surle moteurde recherche de www.biglist.com/lists/xsl-list7archives/ eten restreignantla recherche 
au mois de janvier 2002. 
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Pour fixer les idees, et voir I'interet de la chose, imaginons une application Internet qui 
envoieau client (un navigateur) un tableau desynthesequelconque, commecelui montre 
en exemple figure 9-6. 



Figure 9-6 

U n tableau a 
plusieurs colonnes. 



Fichiet Edition Affichage Favoiis Outils ? 



" ® fa} I d^ ecnelcne ' Favoris ^ Historique 



Produit 


ISBN 


Prix 


Titre 


Auteur 


Inter; rete 


Livre 


193335 


6 


Vingt mille lieues 
sous les mers 


Jules Vemes 




Livre 


533791 


4.5 


L'ingenieur aimait 
trop les chiffres 


Pierre 
Boileau 
Thomas 
Narcejac 




Disque 
Compact 




21 


Les Folies d'Espagne 


Marin 
Marais 


Jonathan Dunford, Basse 
de viole 

Sylvia Abramowicz, Basse 
de viole 

B enj amin P errot, The orb e 
et guitare baroque 
Stephane Fuget, Clave cm 



~3 



J 



Supposons maintenant que I 'interface donne a utilisateur la possibility de designer deux 
colonnes a permuter ; le probleme est de regenerer le meme contenu de tableau, avec la 
meme transformation XSLT, mais presente avec les deux colonnes permutees. 

Le probleme etant assez complexe a resoudre, et necessitant d'ailleurs I'utilisation 
d'extensionsau langageXSLT (qui vontrendrenon portable la solution proposee), il sera 
ici plus facile de proceder par etapes, afin de voir exactement oil se situent les problemes. 
N ous commencerons done par une version qui se contente de generer le tableau de facon 
statique, et qui ne permet done aucune permutation, sauf bien star en all ant modifier le 
programme. 



Version statique 

Le tableau a generer est par exemple un extrait (I i mite aux CD et aux livres) d'inventaire 
d'un magasin, dont le stock est represent par lefichier baseProd uits.xml : 

baseProduits.xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<BaseProduits> 

<LesProduits> 
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<l_ivre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="6" monnaie="EUR"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 



<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" 

media="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="4.5" monnaie="EUR"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 



<Enregistrement ref="marai si" Ref Editeur="LC000280" 

gamme="viol edegambe" mediae "CD" > 

<refOeuvres> 

<Ref valeur="marais.folies"/> 
<Ref valeur= "ma rais. pieces 1685 "/> 
</refOeuvres> 
<Interpretes> 

<Interprete nom=" Jonathan Dunford"> 

<Role xml : 1 ang="f r"> Basse de viole </Role> 
<Role xml : 1 ang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Sylvia Abramowicz"> 

<Role xml : 1 ang="f r"> Basse de viole </Role> 
<Role xml : 1 ang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete nom=" Benjamin Perrot"> 

<Role xml : 1 ang="f r"> Theorbe et guitare baroque </Role> 
<Role xml : 1 ang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Stephane Fuget"> 

<Role xml : 1 ang="f r"> Clavecin </Role> 
<Role xml : 1 ang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 
<Titre xml : 1 ang="f r"> 

Les Folies d'Espagne et pieces inedites 
</Titre> 

<Titre xml : 1 ang="en"> Folies d'Espagne and unedited music </Titre> 
<Prix valeur="21" monnaie="EUR"/> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 
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<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamme="lecteurCD" 

marque="HarKar"> 

<refCaracteristiques> 

<Ref val eur="caracHarKarl"/> 
</refCaracteri stiques> 
<Prix valeur="686" monnaie="EUR"/> 
<Prix val eur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<LesOeuvres> 

<0euvre ref="200001 slm"> 

<Titre> Vingt mi 11 e lieues sous les mers </Titre> 
<refAuteurs> 

<Ref val eur="JVernes"/> 
</refAuteurs> 
</0euvre> 

<0euvre ref="marais.folies"> 

<Titre> Les Folies d'Espagne </Titre> 

<refAuteurs> 

<Ref valeur="MMarais"/> 

</refAuteurs> 
</0euvre> 

<0euvre ref="marai s .piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 

<refAuteurs> 

<Ref valeur="MMarais"/> 

</refAuteurs> 
</0euvre> 

<0euvre ref="liatlc.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref val eur="ThNarcejac"/> 
</refAuteurs> 
</0euvre> 
</LesOeuvres> 

<LesAuteurs> 

<Auteur ref="JVernes"> 

<Nom> Jules Vernes </Nom> 
</Auteur> 

<Auteur ref="MMarais"> 

<Nom> Marin Marais </Nom> 
</Auteur> 

<Auteur ref="PBoileau"> 

<Nom> Pierre Boileau </Nom> 
</Auteur> 
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<Auteur ref="ThNarcejac"> 

<Nom> Thomas Narcejac </Nom> 
</Auteur> 
</LesAuteurs> 



<LesGammes> 

. . . inuti 1 ise ici . . . 
</LesGammes> 



<LesMarques> 

. . . inuti 1 ise ici . . . 
</LesMarques> 

<LesCaracteri stiques> 

. . . inuti 1 ise ici . . . 
</LesCaracteri stiques> 



</BaseProduits> 

Le programme XSLT pour obtenir le tableau statiquement ne pose aucune difficult^ 
particul iere. II y a une regie par element d'inventaire (Livre ou Enegistrement), et 
dans chacunedeces deux regies, on construit unelignedu tableau avec I a total ite des 
colonnes. Si une colonne est sans objet pour I 'element courant (par exemple un No 
ISBN pour un disque), on instancie une espace non secable, sinon on instancie la 
valeur concerned recuperet plus ou moins simplement dans le document XML, le 
plus complique etant I'instanciation des noms d'auteurs. S'il y a plusieurs auteurs ou 
plusieurs interpretes, ils sont tous copies dans la cellule courante du tableau ; par 
contre, s'il y a plusieurs ceuvres dans le meme livreou le memeenregistrement, seule 
la premiere est prise en compte. 

baseProduits.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl : tempi ate match="/"> 
<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<BODY> 

<xsl :apply-templates/> 
</BODY> 
</HTML> 

</xsl :templ ate> 



<xsl :template match="l_esProduits"> 
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<table border="l"> 
<tr> 

<th>Produit</th> 
<th>ISBN</th> 
<th>Prix</th> 
<th>Titre</th> 
<th>Auteur</th> 
<th>Interprete</th> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :templ ate> 

<xsl : tempi ate match="Livre"> 
<tr> 

<td>Livre</td> 

<td><xsl :value-of select="@NoISBN"/X/td> 

<td><xsl : val ue-of sel ect=" . /Prix[@monnaie=' EUR' ]/@valeur"/X/td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-ti treOeuvre"> 
<xsl :with-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl : call -tempi ate> 
</td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-nomsAuteurs"> 
<xsl :with-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl :cal 1 -tempi ate> 
</td> 

<td><xsl :call-template name="instancier-nbsp"/X/td> 
</tr> 
</xsl :templ ate> 

<xsl :template match="Enregi strement"> 
<tr> 

<td>Disque Compact</td> 

<td><xsl :cal 1 -tempi ate name="instancier-nbsp"/X/td> 

<td><xsl : val ue-of sel ect=" . /Prix[@monnaie=' EUR' ]/@valeur"/X/td> 

<td> 

<xsl :cal 1 -tempi ate name="instancier-titreOeuvre"> 
<xsl :with-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl :cal 1 -tempi ate> 
</td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-nomsAuteurs"> 
<xsl :with-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl :call-template> 
</td> 
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<td> 

<xsl :call - tempi ate name="instancier-interpretes'7> 
</td> 
</tr> 
</xsl :template> 

<xsl :templ ate match="text( ) "/> 

<xsl :template name="instancier-titreOeuvre"> 

<xsl:param name="refOeuvre"/> 

<xsl :variable name="Oeuvre" 

select= V/LesOeuvres/Oeuvre[@ref=$refOeuvre]"/> 

<xsl :value-of select="$Oeuvre/Titre"/> 
</xsl :template> 

<xsl : tempi ate name="instancier-nomsAuteurs"> 
<xsl:param name="refOeuvre"/> 
<xsl :variable name="Oeuvre" 

select="//LesOeuvres/Oeuvre[@ref=$refOeuvre]"/> 
<xsl :for-each select="$Oeuvre/refAuteurs/Ref "> 

<xsl :variable name="refAuteur" sel ect="@val eur"/> 
<xsl : vari abl e name="Auteur" 

select= V/LesAuteurs/Auteur[@ref=$refAuteur]'7> 

<xsl :value-of select="$Auteur/Nom"/> 
<xsl:if test="position() != last()"Xbr/X/xsl :if> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate name="instancier-interpretes"> 

<xsl :for-each select="Interpretes/Interprete"> 
<xsl :value-of select="@nom"/> 
<xsl:text>, </xsl:text> 

<xsl : val ue-of select="Role[@xml :lang = 'fr']"/> 
<xsl:if test="position() != 1 ast( ) "Xbr/X/xsl : i f> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :template name="instancier-nbsp"> 

<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp; 
</xsl :template> 

</xsl :stylesheet> 

Arrive a ce stade, on voit deja que ce n'est pas simple de permuter deux colonnes : il faut 

intervenir dans leS troiS regies aSSOCieesaUX elements Produits, Livre et Enregistrement, 

et permuter (dela memefa?on dans ces trois endroits) les lignes source XSLT representant 
unecolonne. 
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Version dynamique 

L'idee d'une generation dynamique, c'est toujours d'interpreter des donnees au lieu de 
les cabler dans le programme. Ici, nous al Ions done mettre en place un document XM L 
qui va decrire la facon dont on veut que les colonnes apparaissent dans le fichier HTM L 
genere. Voici une possibility parmi d'autres, qui montre un exemple d'un tel fichier : 

Table.xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<tabl e id="Li v res Et En regis trements"> 

<colonne titre="Produit"> 
<Li vre 

valeur="Livre"/> 
<Enregi strement 

val eur="Compact Disc"/> 
</col onne> 

<colonne titre="Prix"> 
<Li vre 

eval=" . /Prix[@monnaie=' EUR' ]/@valeur"/> 
<Enregi strement 

eval =" . /Prix[@monnaie=' EUR' ]/@valeur"/> 
</col onne> 

<colonne titre="ISBN"> 
<Li vre 

eval="./@NoISBN"/> 
<Enregi strement 

cal 1 ="instancier-nbsp"/> 
</col onne> 

<colonne titre="Auteur"> 
<Li vre 

cal l="instancier-nomsAuteurs" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
<Enregi strement 

cal 1 ="instancier-nomsAuteurs" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
</col onne> 

<colonne titre="Titre"> 
<Li vre 

cal 1 ="instancier-ti treOeuvre" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
<Enregi strement 

cal 1 ="instancier-ti treOeuvre" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
</col onne> 
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<colonne titre="Interprete"> 
<Livre 

cal l="instancier-nbsp"/> 
<Enregistrement 

cal l="instancier-interpretes"/> 
</colonne> 
</table> 

Ce document decrit une table qui contiendra des livres et des enregistrements, donne 
I'ordre des colonnes, et decrit, pour chaque element <i_ivre> ou <Enregistrement> du 
document source principal, la facon d'aller y recuperer les donnees. 

Certaines donnees, fournies par I'attribut vaieur, sont a prendre tell es quel les : par exem- 
ple, la colonne Produit contient iure pour un <i_ivre>, ou compact Disc pour un 
<Enregistrement> : il n'y a done pas de donnees a aller chercher dans ce cas. 

D'autres donnees sont des expressions X Path a interpreter ; ce sont eel les qui sont four- 
nies par I 'attri but evai. A I 'execution, il faudra done interpreter dynamiquement ces 
expressions X Path, et e'est la qu'interviendra la fonction d'extension evaiuate( ), dispo- 
nibleavec le processeur Saxon ou Xalan. 

Enfin certaines donnees sont obtenues par un cheminement trap complique pour etre 
exprime directement par une expression XPath ; dans ce cas on donne le nom d'un 
modele nomme qu'il faudra executer (attri but can), eton lui transmeteventuellement un 
parametre (attri but param). Si I'attribut param est present, il contient une expression 
XPath qu'il faudra interpreter. 

Le fait d'avoir commence par la version statique permet d'anticiper les difficul tes 
d'acces aux donnees : en particulier, on sait que la recuperation des noms d'auteurs 
n'est pas simple, car il peuty en avoir plusieurs par ceuvre, ce qui implique une bou- 
cle <xsi : for-each> (d'ou I'appel a un modele nomme). Notons en passant que 
I'appel d'un modele nomme dont le nom est contenu dans une variable est interdit en 
XSLT : la encore, il faudra faire appel a une extension, qui rend possible I'utilisation 
d'un descripteur de valeur differee pour I'attribut name de ^instruction <xsi :caii- 

templ ate>. 

Ceci etant, ce fichier de description doit permettre de changer I'ordre d'apparition des 
colonnes dans le tableau, tout simplement en permutant les deux elements correspon- 
dents. Ce n'est d'ailleurs pas la seule facon : on peut aussi laisser ce fichier intact et 
transmettre le nom et I'ordre des colonnes au programme d'interpretation, mais nous 
verrons cette deuxieme solution plus loin. 

II est clair que ce fichier apporte plus de souplesse que la simple permutation facile de 
colonnes: il est tres facile, par exemple, d'ajouter un nouvel element a prendre en 
compte dans I'inventaire, si toutefois une simple expression X Path peut en venir a bout. 
S'il fautun modele nomme, cela implique une modification du programme pour y ajouter 
ce modele nomme. 
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Pattern 

Le pattern consiste a mettre en place I'enchainement suivant, que I 'on va maintenant 
expliciter sur un exemple. 

Etape 1 : traitement d'un element qui doit figurer dans le tableau. Par exemple, trai te- 
rn en t d'un element <uvre> du document source principal (baseProduits.xmi). Cet 
element est mis dans un node-set Eiementcourant necontenant que cet element. 

Etape 2: constitution d'un node-set ei ementsPi i otes contenant tous les elements 
<uvre> du document Tabie.xmi. Ce node-set est appele EiementsPiiotes parce qu'il 
contient effectivement des elements, et que ces elements pilotent le processus de recupe- 
ration des donnees i nteressantes. Dans notre exemple, ce node-set contient tous les 
<uvre> du document Tabi e .xmi , et pour chacun d'eux on trouvesoitun attribut vaieur, 
soit un attribut evai, soit un attribut can, qu'il va falloir interpreter. 

Etape 3 : constitution du texte de I 'expression permettant I'acces a la donnee, et inter- 
pretation dynamique de ce texte d'expression. 

Etape 3A : cas de I ' attri but vaieur, qui est le plus simple. En effet, il n'y a rien de parti- 
culier a faire dans ce cas, si ce n'est de prendre en compte la vaieur fournie. 

Etape 3B : cas de I 'attribut evai, qui est le plus typique. On recupere une chalne de 
caracteres, par exemple ./Prix[@monnaie='EUR']/@vaieur. Cette chalne de caracteres 
doit etre rapprochee de I 'element courant <uvre> contenu dans le node-set Eiement- 
courant. En effet, I 'expression a interpreter est 

$ ElementCourant/ . /Prix[@monnaie=' EUR' ]/@val eur 

Le ■/./' median amene une redondance, mais qui est inoffensive (et que I'on pourrait 
facilement supprimer). Le texte de cette expression resulte de la concatenation des trois 
chaines de caracteres : 

'$ElementCourant' 
7' 

. /Prix[@monnaie=' EUR' ]/@val eur 

Les deux premieres sont des chaines litterales, et la derniere est la vaieur de I 'attri but 
evai del'element pilote courant, desortequel'appel a la fonction concato correspondant 
va s'ecrire : 

concat( '$ElementCourant' , '/', @eval) 

Eta I'execution, cetappel va fournir I 'expression : 

$ ElementCourant/ ./Prix[@monnaie=' EUR' ]/@val eur 

Dans cet exemple, n'oublions pas que ElementCourant est un node-set ne contenant que 
le <Livre> du document principal en cours de traitement. De sorte que cette expression, 
si on I'interprete, donne la vaieur du prix en euros du <Livre> courant, etc'estbien cette 
vaieur qu'il fallait recuperer pour la placer dans une cellule de tableau. 
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devaluation se fait par appel d'une fonction d'extension, fournie par Saxon et Xalan. 
Avec Saxon, I 'appel prend la forme suivante : 

saxon :eval uate( 

concatt '$ElementCourant' , '/', @eval) 

) 

Etape3C : cas de I ' attri but can, avec presence d'un attri but param, par exemple : 

I< Li vre 
cal 1 ="instancier-nomsAuteurs" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 

1 1 faut a nouveau rapprocher la chaine fournie par I 'attri but param de I 'element courant du 
document source principal ; on opere done la concatenation des trois chaines : 

'$ElementCourant' 

. /refOeuvres/Ref [l]/@val eur 

Les deux premieres sont des chaines litterales, et la derniere est la valeur de I'attri but 
param de I 'element pi lote courant, de sorte que I 'appel a la fonction concat ( ) correspondant 
va s'ecrire : 

concatt '$ElementCourant' , '/', @param) 

Eta I'execution, apres evaluation par la fonction saxon:evaiuate(), cet appel va fournir 
I 'expression : 

$E1 ementCourant/ ./refOeuvres/Ref [l]/@val eur 

Dans cet exemple, n'oublions pas que Eiementcourant est un node-set ne contenant que 
le<Livre> du document principal en cours detraitement. De sorte que cette expression, 
si on I'interprete, donne la valeur de la premiere reference d'eeuvre du <i_ivre> courant. 

Cette valeur va done jouer le role d'argument pour I'appel du modele nomme dont le 
nom est la valeur de I'attri but cai 1 de I'element pilote. 

Quant a I'appel proprement dit du modele nomme, il doit prendre une forme speciale, 
parce qu'en XSLT standard, un tel appel est impossible. En effet, le nom du modele a 
appeler n'est pas ici connu statiquement, chose qu'XSLT interdit. Pour pouvoir tout de 
meme appeler ce modele, il faut done utiliser une forme ou un descripteur de valeur dif- 
fered d'attri but est autorise, ce qui constitue une extension au langage, fournie par Saxon 
de la maniere suivante : 

<xsl : call -template name="{$tname}" saxon:allow-avt="yes"> 

On peutmaintenantdonner le programme d' interpretation de la specification de disposition 
du tableau. 

baseProduits.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
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xmlns:saxon="http://icl .com/saxon" 
extension -el ement-pref ixes="saxon" 
version = "1.0"> 

<xsl:output method='html ' encoding=' ISO-8859-1 ' /> 

<xsl :variable 

name="tablel_i v res Et En regis trements" 

select="document( 'Table.xml ' )/tabl e[@id=' Li vresEtEnregistrements ' ]"/> 

<xsl :variable 

name="racineDocumentPrincipal " 
select="/"/> 

<xsl : tempi ate match="/"> 
<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<B0DY> 

<xsl :apply-templates/> 
</B0DY> 
</HTML> 
</xsl :templ ate> 

<xsl :template match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl :cal 1 -tempi ate name="instancier-titresColonnes"/> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :templ ate> 



<!-- 

Etape 1 

<xsl : tempi ate match="Livre"> 
<tr> 

<xsl :call-template name="instancier-colonnes"/> 
</tr> 
</xsl :templ ate> 

<!-- 

Etape 1 

<xsl :template match="Enregi strement"> 
<tr> 
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<xsl : call -tempi ate name="instancier-colonnes"/> 
</tr> 
</xsl :templ ate> 

<!-- 

====================================================== --> 

<xsl : tempi ate match="text( ) "/> 



<!-- 



Fin des regies 

====================================================== --> 

<xsl :template name="instancier-titresColonnes"> 

<xsl :for-each select="$tabl eLi vresEtEnregistrements/col onne"> 
<th><xsl :value-of select="@titre"/X/th> 

</xsl :for-each> 
</xsl :template> 

<! > 

<xsl :template name="instancier-colonnes"> 
<! — 

Comme ce modele est appele depuis une regie sans xsl :for-each, 
1 'element courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 
--> 

<xsl :variable name="El ementCourant" sel ect="current( )"/> 
<xsl :variable name="El ementName" select="l ocal -name( )"/> 



<! — 

Etape 2 

====================================================== --> 

<xsl :variable 

name=" Elements Pi lotes" 

sel ect= "s axon :eval uate( 
concat( 

' $tabl eLi vresEtEnregi strements/col onne/ ' 
$E1 ementName 

) 

)" 

/> 
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Valeur de la variable SElementsPilotes dans notre exemple : 



cas ou SElementCourant est un <Livre> 



<l_ivre valeur="Livre"X/Livre> 

<Livre eval=" . /Prix[@monnaie=' EUR' ]/@val eur"X/Li vre> 
<Livre eval="./@NoISBN"X/Livre> 

<Li vre cal 1 ="instancier-nomsAuteurs" 

param=" . /refOeuvres/Ref [l]/@val eur"X/Li vre> 

<Li vre cal 1 ="instancier-ti treOeuvre" 

param=" . / refOeuvres/Ref [l]/@val eur"X/Li vre> 

<Li vre cal 1 ="instancier-nbsp"X/Li vre> 



cas ou SElementCourant est un <Enregi strement> 



<Enregistrement val eur="Compact Disc"X/Enregistrement> 
<Enregistrement eval =" . /Prix[@monnaie=' EUR' ]/@valeur"> 
</Enregistrement> 

<Enregistrement cal 1 = "instancier-nbsp"X/Enregistrement> 

<Enregistrement cal 1 ="instancier-nomsAuteurs" 

param=" . /refOeuvres/Ref [l]/@val eur"> 
</Enregistrement> 

<Enregi strement cal 1 ="instancier-ti treOeuvre" 

param=" . /refOeuvres/Ref [l]/@val eur"> 
</Enregistrement> 

<Enregi strement cal 1 ="instancier-interpretes"> 
</Enregistrement> 
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<!-- 



--> 



Etape 3 



> 



<xsl :for-each select="$ElementsPilotes"> 
<td> 

<xsl :choose> 
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<!-- 

Etape 3A 

<xsl:when test="@val eur"> 

<xsl :value-of select="@valeur"/> 
</xsl :when> 

<!-- 

Etape 3B 



<xsl :when test="@eval "> 

<xsl :value-of select="saxon:evaluate( 
concat( 'SElementCourant' , '/', @eval ) 

)"/> 
</xsl :when> 



<!-- 

Etape 3C 

====================================================== -_> 

<xsl:when test="@cal 1 "> 

<xsl :choose> 

<xsl :when test="@param"> 
<xsl :cal 1 -tempi ate 

name=" {@cal 1 }" saxon:allow-avt="yes"> 
<xsl :with-param 

name="refOeuvre" 
select="saxon:eval uate( 

concat( '$ElementCourant' , 

' / ' , @param) 

)"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl icall-template 

name="{@call }" saxon:allow-avt="yes"> 
<xsl :with-param 

name="ElementCourant" 
select="$El ementCourant"/> 
</xsl :call-template> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :when> 
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</xsl :choose> 
</td> 
</xsl : for-each> 
</xsl :templ ate> 

<! > 

<xsl :template name="instancier-titreOeuvre"> 
<xsl:param name="refOeuvre"/> 
<xsl :variable 

name="Oeuvre" 

select=" 

$racineDocumentPrincipal //Les0euvres/0euvre[@ref=$ref0euvre]'7> 
<xsl :value-of sel ect="$0euvre/Titre'7> 
</xsl : tempi ate> 



<! > 

<xsl :template name="instancier-nomsAuteurs"> 
<xsl:param name="ref0euvre'7> 
<xsl :variable 

name="Oeuvre" 

select=" 

$racineDocumentPrincipal //Les0euvres/0euvre[@ref=$ref0euvre]'7> 
<xsl :for-each sel ect="$Oeuvre/refAuteurs/Ref "> 

<xsl :variable name="refAuteur" sel ect="@val eur"/> 
<xsl :variable 

name="Aiiteur" 

sel ect="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 
<xsl :value-of select="$Auteur7Noiri"/> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 
</xsl :for-each> 
</xsl :templ ate> 



<! > 

<xsl :template name="instancier-interpretes"> 
<xsl :param name="El ementCourant"/> 

<xsl :for-each sel ect="$El ementCourant/Interpretes/Interprete"> 
<xsl : val ue-of sel ect="@noiri"/> 
<xsl:text>, </xsl:text> 

<xsl :val ue-of sel ect="Rol e[@xml :lang = 'fr']"/> 
<xsl:if test="position( ) != last( )"><br/X/xsl :if> 
</xsl :for-each> 
</xsl :templ ate> 



<! > 

<xsl :template name="instancier-nbsp"> 
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<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp; 
</xsl :templ ate> 

</xsl :stylesheet> 

Un element qu'il fauttoujours prendre en compte, pour I'instanciation d'un model e, c'est 
que le contexte devaluation ne change pas de I 'appelant a I'appele : or, ici, certains des 

ITIOdeleS nommeS (instancier-nomsAuteurs, i nstanci er-i nterpretes, par exemple) 

sont appeles a I'interieur de la boucle sur les elements pilotes (etape 3). Cette boucle 
change le contexte devaluation : en particulier le noeud courant est un element pilote, 

done un element du document XML Table. xml. Or le modele nomme instancier- 
nomsAuteurs, par exemple, evalue I 'expression XPath 

//LesOeuvres/Oeuvre[@ref=$refOeuvre] 

Si I 'on ne fait rien de particulier, cette expression sera done evaluee par rapport a un 
noeud contexte situe dans le document Table. xml, ce qui n'a evidemment aucun sens. II 
est done necessaire de retrouver le document principal lors de devaluation de cette 
expression, cequi est rendu possible par la variable globale racineDocumentPrincipai . 

A I'execution, les colonnes du tableau s'affichent dans I 'ordre oil el les apparaissent dans 
le document Tabi e.xmi (voir figure 9-7). 



Figure 9-7 

U n tableau dont les 
colonnes (ordre et 
contenu) sont 
spe'ci/z<?es a part. 



■An}*} 



Fichiet Edition Affichage Favotis Outils ? 



" 3 0 t25 h ^Rechetcher Favotis ^jHistotique 



~3 



Produit 


Prix 


ISBN 


A mem 


Titre 


Inteiprete 


Livre 


6 


193335 


Jules 
V ernes 


Vingtmille lieues 
sous les mers 




Livre 


45 


533791 


Pierre 
Boileau 
Thomas 
Narcejac 


L'ingenieur aimait 
trop les chifrres 




Compart 
Disc 


21 




Marin 
Marais 


Les Folies 
d'Espagne 


Jonathan Dunf ord, 
Basse de viole 
Sylvia Abramowic^ 
Basse de viole 
Benjamin Perrot, 
The orb e et guitare 
baroque 

Stephane Fuget, 
Clavecin 



J 



II est vrai que la solution obtenue peut ne pas resoudre tout a fait le probleme pose : en 
effet, puisque I'utilisateur peut dynamiquement demander une permutation de I 'ordre de 
presentation des colonnes, il faut pouvoir repercuter cette demande sur le document 
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Tabie.xmi, et permuter en consequence les deux elements correspondants. C'estevidem- 
ment trivial a real iser en XSLT, mais peut-etre n'est-ce pas la solution que I'on souhaite- 
rait. Une autre solution, plus dynamique, consisterait a indiquer au programme 
d' interpretation (baseProduits.xsi) I'ordre des colonnes souhaite, sous la forme d'un 
parametretransmislorsdel'appel : 

Ligne de commande (d'un seul tenant) 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 
com. icl .saxon. Stylesheet -o baseProduits.html BaseProduits.xml BaseProduits.xsi 
ordreColonnes="Produit Prix Auteur Titre ISBN Interprete" 

Dans ce cas, le document Tabi e.xmi ne sert plus a determiner I'ordre des colonnes, mais 
seulement a specifier I'acces aux donnees. On pourrait aussi choisir une option mixte 
dans laquelle ce document XM L donne I'ordre des colonnes par defaut, en I 'absence du 
parametre ordreCol onnes lors du lancement du processeur. 

Pour obtenir le resultatcherche, il n'y a assez peu de modifications a apporter, car le pat- 
tern reste essentiellement le meme; mais au lieu de boucler sur les elements pilotes 
(etape 3), il faut boucler sur les elements fournis par le parametre ordreCol onnes. 

C'estd'ailleurs une occasion d'utiliser encore une nouvel I e extension, car on saitqu'une 
boucle <xsi : for-each> est adaptee uniquement au parcours de node-sets ; or justement, 
il existe une extension Saxon (ou Xalan) qui transforme une suite de lexemes en un node- 
set d'elements dont les valeurs textuel les sont les lexemes fournis : il s'agit de la fonction 
saxon : tokeni ze( ), que I 'on utilisera done a cettefin. 

baseProduits .xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xmlns:saxon="http://icl .com/saxon" 

extension -el ement-pref ixes=" saxon" 

version = "1.0"> 

<xsl:output method='html ' encoding=' ISO-8859-1 ' /> 

<xsl :param 

name=" ordreCol onnes" 

select="'Produit Prix Auteur Titre ISBN Interprete "7> 
<!-- donne I'ordre par defaut des colonnes --> 

<xsl :variable 

name="tableLi v res Et En regis trements" 

select="document( 'Tables.xml ' )/table[@id=' LivresEtEnregistrements']"/> 

<xsl :variable 

name="racineDocumentPrincipal " 
select="/"/> 

<xsl : tempi ate match="/"> 
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<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<B0DY> 

<xsl :apply-templates/> 
</B0DY> 
</HTML> 
</xsl :templ ate> 

<xsl :template match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl :cal 1 -tempi ate name="instancier-ti tresCol onnes"/> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :template> 

<!-- 



Etape 1 

====================================================== --> 

<xsl :template match="Livre"> 
<tr> 

<xsl : cal 1 -tempi ate name="instancier-colonnes'7> 
</tr> 
</xsl :templ ate> 
<!-- 



Etape 1 

====================================================== --> 

<xsl : tempi ate match="Enregistrement"> 
<tr> 

<xsl : cal 1 -tempi ate name="instancier-colonnes'7> 
</tr> 
</xsl :templ ate> 

<!-- 

====================================================== --> 

<xsl : tempi ate match="text( ) "/> 



<!- 



Fin des regies 
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<xsl :template name="instancier-titresColonnes"> 

<xsl :for-each select="saxon:tokenize( SordreCol onnes )"> 

<th><xsl :value-of sel ect=" . "/></th> 
</xsl : for-each> 

</xsl :templ ate> 

<! > 

<xsl :template name="instancier-colonnes"> 
<! — 

Comme ce modele est appele depuis une regie sans xsl :for-each, 
l'element courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 

--> 

<xsl :variable name="ElementCourant" sel ect="current( ) "/> 
<xsl :variable name="ElementNaine" sel ect="l ocal -name( ) "/> 

<! — 



Etape 3 

====================================================== _-> 

<xsl :variable 

name="LesNomsDeCol onnes" 

select="saxon:tokenize( $ordreColonnes )"/> 

<xsl :for-each sel ect="$l_esNomsDeCol onnes"> 



<xsl rvariable 

name="NomDel_aCol onneEnCours" 
sel ect=" . "/> 

<xsl :variable 

name=" El ementPi 1 ote" 
sel ect="saxon :eval uate( 
concatt 

' StableLi vresEtEnregi strements/col onne[ 
@titre=" ' , 

$NomDeLaCol onneEnCours, '"]/' , 
$E1 ementName 

) 

)" 

/> 

<xsl :for-each select="$ElementPilote"> 
<td> 

<xsl :choose> 
<! — 



Etape 3A 

=============================== --> 
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<xsl :when test="@val eur"> 

<xsl :value-of select="@valeur"/> 
</xsl :when> 



<!- 



Etape 3B 



<xsl :when test="@eval "> 

<xsl :value-of select="saxon:evaluate( 
concat( '$E1 ementCourant' , '/', @eval ) 

)"/> 
</xsl :when> 



<!- 



Etape 3C 



<xsl :when test="@cal 1 "> 

<xsl :choose> 

<xsl :when test="@param"> 
<xsl :cal 1 -tempi ate 

name="{@call }" saxon:allow-avt="yes"> 
<xsl :with-param 

name="refOeuvre" 
select="saxon:eval uate( 

concatt ' $E1 ementCourant ','/', @param) 
)"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :cal 1 -tempi ate 

name="{@call }" saxon:allow-avt="yes"> 
<xsl :with-param 

name=" El ementCourant" 
select="$El ementCourant "/> 
</xsl :call-template> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :when> 



</xsl :choose> 
</td> 

</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 
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<! > 

<xsl :template name="instancier-titreOeuvre"> 
<xsl:param name="refOeuvre"/> 
<xsl :variable 

name="Oeuvre" 

select=" 

SracineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre] "/> 
<xsl :value-of select="$Oeuvre/Titre"/> 
</xsl :templ ate> 

<! > 

<xsl :template name="instancier-nomsAuteurs"> 
<xsl:param name="refOeuvre"/> 
<xsl :variable 

name="Oeuvre" 

select=" 

$racineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre] "/> 
<xsl :for-each sel ect="$Oeuvre/refAuteurs/Ref"> 

<xsl :variable name="refAuteur" sel ect="@val eur"/> 
<xsl :variable 

name="Auteur" 

sel ect="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 
<xsl :value-of select="$Auteur/NoiTi"/> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 
</xsl : for-each> 
</xsl :templ ate> 

<! > 

<xsl :template name="instancier-interpretes"> 
<xsl :param name="El ementCourant"/> 

<xsl :for-each sel ect="$El ementCour ant/ 1 nterpretes/ Interpreted 
<xsl :val ue-of sel ect="@nom"/> 
<xsl:text>, </xsl:text> 

<xsl :val ue-of sel ect="Rol e[@xml :lang = 'fr']"/> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 
</xsl :for-each> 
</xsl :templ ate> 

<! > 

<xsl :template name="instancier-nbsp"> 

<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp; 
</xsl :templ ate> 

</xsl :stylesheet> 
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L'etape 2 a disparu, puisque cette etape consistait dans la version precedente a rassem- 
bler les elements pilotes dans un node-set, chaque element pilote correspondant a une 
colonne. Ici, c'est inutile, puisque la liste des colonnes est deja connue au travers de la 
variable ordreCoionnes. L'etape 3 se transpose done ici en un parcours du node-set 
LesNomsDeCoionnes construit a parti r de cette liste, le node-set en question etant par 
contre constitue de noeuds completement deconnectes du document Tabie.xmi. Done 
pour avoir un element pilote a partir du NomDeLaCoionneEnCours, il faut effectuer une 
recherche de cet element pilote dans le document Tabie.xmi connaissant le nom de la 
colonne courante, et I 'element a traiter (<u vre> ou <Enregistrement>). Cette recherche 
est effectuee par I'expression X Path initial isant la variable EiementPiiote. 

Cette expression X Path est construite a partir des donnees suivantes : 

• $NomDei_aCoionneEnCours : une chaine de caracteres donnant le nom de la colonne 
(par exemple 'Prix") ; 

• $EiementName : une chaine de caracteres donnant le nom de I'element (du document 
principal) en coursdetraitement (par exemple 'Livre'). 

Avec ces donnees, il faut construi re I'expression suivante : 

$tableLivresEtEnregistrements/colonne[@titre="Pr7A"]//.7/re 

Dans cette expression, tout est constant, sauf les deux noms indiques en gras, qui sont des 
valeurs de variables. On peut done construire une chaine de caracteres contenant 
I'expression ci-dessus, par concatenation de constantes I itterales et de valeurs de varia- 
bles, maisil resteleproblemedesguillemets. On utilise ici des entites caracteres pour les 
representer (&#34 ; ), car sous forme litterale, ils entreraient en conflit avec ceux utilises 
pour delimiter I'attribut select contenant I'expression a evaluer, ou avec les delimiteurs 
dechaines I itterales de la fonction concato. 

Unefois I'expression construite, il n'y a plus qu'a I 'evaluer, cequi sefaitcommed'habi- 
tudeparappel a la fonction s axon : eval uate( ). 

Le resultat de cette evaluation est un node-set ne contenant qu'un seul element : un 
element pilote du document Tabie.xmi . Cet element pilote doit maintenant devenir le 
nceud courant, pour nous ramener a la version precedente du programme, ou il y avait 
une boucle sur un node-set d'elements pilotes. C'est la raison de la presence du for- 
each suivant, qui ne sert pas a effectuer une boucle (puisque de toute facon, on est 
certain que le node-set a parcourir ne comporte qu'un seul element), mais sert uni - 
quement a changer de contexte devaluation (voir la section Autre seimantique, 
page 140). 

Unefois que le nceud courant est un element pilote, le reste du programme est essentiel- 
lement identique a celui de la version precedente, et le resultat obtenu est montre a la 
figure 9-8. 



Pattern n 20- Generation de documents multiples 

Chapitre 9 



Figure 9-8 
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colonnes spedfiee 
lors de I 'appel du 
programme. 
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Pattern n° 20- Generation de documents multiples 

Ce pattern va donner un exemple de generation de documents multiples, pour lequel le 
resultat obtenu ne sera done pas un seul richier, mais plusieurs, ce qui permettra par 
exemple a une application de produire tout un ensemble de pages HTM L liees les unes 
aux autres par des liens actifs. 

Nous allons prendre I 'exemple d'un document XM L representant un support de cours, 
divise en pages, commececi : 

XMLXSL.xml 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
presentation titre="Cours XML"> 



<pageDeTitre id="XML.O" nextPage="XML. 1"> 

<titrePresentation>Comprendre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard i d=" XML . 1 " previousPage="XML.O" nextPage="Table"> 
<titrel id="XML.l.Deroulement">Deroulement du Cours</titrel> 
<blocl> 
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<item> 

Le cours XML se deroule de 9h30 a 12h30 et de 14h a 17h30. 
</item> 
<bloc2> 
<item> 

Pauses-cafe a llh et 16h. 

</item> 

<item> 

Discussions libres pendant le dejeuner et apres 17h30. 
</item> 
</bloc2> 
</blocl> 
<blocl> 
<item> 

Le dernier jour, foire aux questions de 16h30 a 17h30. 
</item> 
</blocl> 
</pageStandard> 

<plan id="Table" previousPage="XML.l" nextPage="XML.2"/> 

<pageStandard id="XML.2" previousPage="Table"> 

<titrel id="XML.2general"> XML - Generality </titrel> 
<blocl> 
<item> 

XML est un langage de balisage de textes. 
</item> 
</blocl> 

<titre2 id="XML.2.balisage"> Balisage </titre2> 
<blocl> 
<item> 

Le principe d'un langage de balisage de textes existe depuis 
fort longtemps, 

avant meme 1 'invention de 1 'informatique. 
</item> 
<bloc2> 
<item> 

en imprimerie, le texte de l'epreuve est balisee de 
"corrections" a effectuer (balises textuelles), 
</item> 
<item> 

et les relectures a voix haute, chez les typographes, 

se font agrementees de balises vocales codifiees, avec tout un 

argot de metier assez savoureux (trouve dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques Andre, 

in Cahier GUTemberg No 31, Decembre 1998) : 

</item> 
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<bloc3> 
<item> 

le metro (invente par Bienvenue ! ...) 

</item> 

<item> 

le metro <texteImportant>ouvre</texteImportant> invente 
par Bienvenue <texteImportant>cap couilles clame suce ferme 
</texteImportant> 
</item> 
</bloc3> 



<item> 

Avec 1 'invention de 1 'informatique, les techniques de balisages 
se sont appliquees a la commande des Linotypes par bandes 
perforees, ou le texte a composer etait parseme de commandes 
destinees a la manoeuvre de la Lynotype el 1 e meme (passer en gras, 
changer de corps, faire un retrait, etc.). 



</item> 
</blocl> 
</pageStandard> 

</presentation> 

Le but est done d'obtenir une serie de pages HTM L, une par <pagestandard>, <pageDe- 
Titre>, ou <pian> du document XML. Le nom de chaque fichier resultat sera forme 

d'apreS I'attribut id de Chaque <pageStandard>, <pageDeTitre>, OU <plan>, auquel On 

ajoutera le suffixe ■ .html •. 

Done dans le notre exemple, on obtiendra au final les fichiers XML.o.htmi, XML.i.htmi, 
tabie.htmi, et xml. 2. html (voir figures 9-9 a 9-12). 



</bloc2> 



</blocl> 
<blocl> 



Figure 9-9 

Premiere page. 
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Figure 9-10 

Deuxieme page. 
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Le coeur du programme est constitue d'un modele nomme qui instancie les pages HTML 
suivant un format pre-determine : en-tete, corps de page, pied de page. L'en tete est en 
fait une barre de navigation permettant de passer de page en page en avant ou en arriere, 
ou d'aller directement a la table des matieres : 

<xsl :template name="instancier-page"> 

<xsl:param name="f i 1 eName"/> 
<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<xsl :document href="{$fileName}"> 

<xsl : cal 1 -tempi ate name="instancier-entete"> 

<xsl :with-param name="next" sel ect="concat( $next, '.html')" /> 
<xsl :with-param name="prev" sel ect="concat( $prev, '.html')" /> 
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Figure 9-12 

Troisieme page. 
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</xsl :cal 1 -tempi ate> 

<TABLE width="100%" hei ght="90%" B0RDER="0" CELLSPACING="10"> 
<TR val ign="top"XTD> 

<xsl :apply-templates/> 
</TDX/TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</xsl :document> 

</xsl : tempi ate> 

L'instruction <xsi : document href =" . . . ">, utilisee ci-dessus, permet de diriger la 
serialisation de son modele de transformation vers un fichier dont I'URI est fourni par 

I'attribut href. 
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Cette instruction n'est pas une instruction du langage XSLT 1.0, qui ne fournit aucun 
moyen standard decreer plusieurs fichiers resultats. II est done necessaire, ici, d'utiliser 
une extension, qui se trouve disponible par exemple dans Xalan (sous une forme tres 
differente de eel le qui est montree ci-dessus). 

Longtemps el le a ete aussi proposee par le processeur Saxon (mais sous une forme lege- 
rement differente de la version ci-dessus). Puis le Working Draft 1.1 est paru, et a pro- 
pose une evolution permettantjustement la creation de plusieurs fichiers resultat, sous la 
forme montree ci-dessus. M ichael Kay a alors implements la nouvelle forme proposee, 
cequi faitqu'il est possi bl e de I ' uti I i ser commesi e'etait une instruction normale(etnon 
pas une extension), a condition d'indiquer au moins 1.1 comme numero de version de 
langage XSLT. 

Signalons pour terminer que I 'extension proposee par Xalan peut etre plus pratique dans 
certains cas; el I e se decompose en trois fonctions: xaian:open( ), xaian:write(), et 
xalan: closet ). Cela permet de constituer un fichier petit a petit, alors qu'avec I 'instruc- 
tion xsi :document, il faut le constituer d'un seul coup en un seul bloc. Si done plusieurs 
instructions xsi rdocument sont executees avec le meme nom de fichier, le fichier est 
ouvert et referme a chaque fois, et chaque ecriture ecrase la precedents. Au contraire, 
avec I 'extension proposee par Xalan, il est facile decreer un fichier par ajouts successifs, 
par exemple pour conserver une trace de I 'execution d'un programme XSLT, lorsqu'on 
recherche la cause d'une erreur coriace a detecter. 

Voici maintenant le programme, qui nemetrien enceuvrequi n'aitdejaete vu. 

XMLXSL.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transform" 
version="l . 1"> <!-- compatibility Saxon 6.5 --> 

<xsl:output method='html ' encoding='IS0-8859-l' /> 



<! — 

====================================================== --> 

<xsl :template match="pageDeTitre"> 

<xsl : call -tempi ate name="instancier-page"> 

<xsl :with-param name="fileName" sel ect="concat( @id, '.html' )" /> 
<xsl :with-param name="next" sel ect="@nextPage" /> 
</xsl :call-template> 
</xsl :template> 

<xsl :template match="titrePresentation"> 

<H1 al ign="center"Xxsl :value-of select=" . "/></Hl> 
</xsl :templ ate> 

<xsl :templ ate match="auteur"> 

<H2 align="center"Xxsl :value-of select=" . "/></H2> 
</xsl :templ ate> 
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<xsl :template match="societe"> 

<H2 align="center"Xxsl :value-of sel ect=" . "/X/H2> 
</xsl :templ ate> 

<!-- 

====================================================== _-> 

<xsl :template match="pageStandard"> 

<xsl :call-template name="instancier-page"> 

<xsl :with-param name="fi 1 eName" sel ect="concat( @id, '.html' )" /> 
<xsl :with-param name="prev" select="@previousPage" /> 
<xsl :with-param name="next" sel ect="@nextPage" /> 
</xsl : call -tempi ate> 
</xsl :templ ate> 

<xsl : tempi ate match="titrel"> 

<H1 align="left"Xxsl :value-of sel ect=" . "/X/H1> 
</xsl :templ ate> 

<xsl :template match="titre2"> 

<H2 align="left"Xxsl :value-of sel ect=" . "/X/H2> 
</xsl :templ ate> 

<xsl :template match="blocl"> 

<UL TYPE="SQUARE"Xxsl : apply-templ ates/X/UL> 
</xsl :templ ate> 

<xsl :template match="item"> 

<LIXxsl :apply-templates/X/LI> 
</xsl :templ ate> 

<xsl :template match="bl oc2"> 

<UL TYPE="CIRCLE"Xxsl : apply-templ ates/X/UL> 
</xsl :templ ate> 

<xsl :template match="bl oc3"> 

<UL TYPE="DISCXxsl : apply-templ ates/X/UL> 
</xsl :templ ate> 

<xsl :template match="texteImportant"> 

<BXxsl :apply-templates/X/B> 
</xsl :templ ate> 

<!-- 

====================================================== _-> 

<xsl :template match="pl an"> 

<xsl :cal 1 -tempi ate name="instancier-pl an"> 

<xsl :with-param name="fi 1 eName" sel ect="concat( @id, '.html' )" /> 
<xsl :with-param name="prev" select="@previousPage" /> 
<xsl :with-param name="next" sel ect="@nextPage" /> 
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</xsl :call-template> 
</xsl :templ ate> 



<xsl :templ ate match="titrel" mode="plan"> 
<H1 align="left"> 

<A HREF="{concat(parent: :*/@id, '.html')}"> 
<xsl :value-of select="."/> 
</A> 
</Hl> 
</xsl :templ ate> 

<xsl :templ ate match="titre2" mode="plan"> 
<H2 align="left"> 

<A HREF="{concat(parent: :*/@id, '.html')}"> 
<xsl :value-of select="."/> 
</A> 
</H2> 
</xsl :templ ate> 

<xsl :templ ate match="text( )" mode="plan"/> 
<!-- 

====================================================== --> 

<!-- --> 

<xsl : tempi ate name="instancier-page"> 

<xsl:parant name="f i 1 eName"/> 
<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<xsl :document href="{$fileName}"> 
<HTML> 

<HEAD> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<xsl : call -tempi ate name="instancier-entete"> 

<xsl :with-param name="next" sel ect="concat( $next, '.html')" /> 
<xsl :with-param name="prev" sel ect="concat( $prev, '.html')" /> 

</xsl :call-template> 

<TABLE width="100%" height="90r B0RDER="0" CELLSPACING="10"> 
<TR val ign="top"XTD> 

<xsl :apply-templates/> 
</TDX/TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</B0DY> 
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</HTML> 

</xsl :document> 
</xsl :templ ate> 
<!-- --> 

<xsl :template name="instancier-entete"> 

<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<TABLE valign="top" width="100r height="2%" B0RDER="0" CELLSPAC I NG="0" 

BGC0L0R="#FFFF99"> 

<TR> 

<TD width="33%" al i gn="l ef t"> 

<A HREF="{$prev}">Page precedente</A> 

</TD> 

<TD width="34%" align="center"> 
<A HREF="Table.html">Table</A> 
</TD> 

<TD width="33%" align="right"> 
<A HREF="{$next}">Page suivante</A> 
</TD> 
</TR> 
</TABLE> 
</xsl : tempi ate> 



<!-- --> 

<xsl :template name="instancier-piedDePage"> 

<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<TABLE valign="top" width="100%" height="2%" B0RDER="0" CELLSPACI NG="0" 

BGC0L0R="#FFFF99"> 

<TR> 

<TD width="33%" al i gn="l ef t">Ph . Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Comprendre XML et XSL</TD> 
<TD width="33r al i gn=" ri ght"> 

<xsl :number count="pageDeTitre | pageStandard | plan" level="any"/> 
</TD> 
</TR> 
</TABLE> 
</xsl :templ ate> 



<!-- --> 

<xsl :template name="instancier-plan"> 
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<xsl:param name="f i 1 eName"/> 
<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<xsl :document href="{$fileName}"> 
<HTML> 

<HEAD> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<xsl : call -tempi ate name="instancier-entete"> 

<xsl :with-param name="next" sel ect="concat( $next, '.html')" /> 
<xsl :with-param name="prev" sel ect="concat( $prev, '.html')" /> 

</xsl :call-template> 

<TABLE width="100%" hei ght="90%" B0RDER="0" CELLSPACING="10"> 
<TR val ign="top"XTD> 

<xsl :apply-templates sel ect="//pageStandard" mode="pl an"/> 
</TDX/TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</B0DY> 
</HTML> 

</xsl :document> 
</xsl :templ ate> 



</xsl :stylesheet> 

L e dernier fichier obtenu, parexemple, estcelui-ci : 

XML.2.htm1 

<HTML> 
<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<TABLE valign="top" width="100%" hei ght="2%" B0RDER="0" CELLSPACI NG="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t"XA HREF="Table.html"> 
Page précédente</AX/TD> 

<TD width="34%" al i gn="center"XA HREF="Table.html">Table</AX/TD> 
<TD width="33%" al ign="right"XA HREF=" .html">Page suivante</A> 
</TD> 
</TR> 
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</TABLE> 

<TABLE width="100r hei ght="90%" B0RDER="0" CELLSPACING="10"> 
<TR val ign="top"> 
<TD> 

<H1 align="left"> XML - Généralités </Hl> 
<UL TYPE="SQUARE"> 
<LI> 

XML est un langage de balisage de textes. 
</LI> 
</UL> 

<H2 align="left"> Balisage </H2> 
<UL TYPE="SQUARE"> 
<LI> 

Le principe d'un langage de balisage de textes 

existe depuis fort longtemps, 

avant m&eci rc;me 1 'invention de 1 'informatique. 

</LI> 

<UL TYPE="CIRCLE"> 
<LI> 

en imprimerie, le texte de 1 'épreuve est 
bal isée de 

"corrections" à effectuer (balises textuelles), 
</LI> 
<LI> 

et les relectures à voix haute, chez les 
typographes , 

se font agrémentées de balises vocales 
codifiées, avec tout un 

argot de métier assez savoureux (trouvé 
dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques 
André , in 

Cahier GUTemberg No 31, Décembre 1998) : 
</LI> 

<UL TYPE="DISC"> 

<LI> 

le métro (inventé par 

Bienven&uuml ;e ! . . . ) 
</LI> 
<LI> 

le métro <B>ouvre</B> inventé 
par Bienven&uuml ;e <B>cap couilles clame suce ferme 
</B> 

</LI> 
</UL> 
</UL> 
</UL> 

<UL TYPE="SQUARE"> 
<LI> 

Avec 1 'invention de 1 'informatique, les techniques de 
bal isages 
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se sont appl iquées à la commande des 
Linotypes par bandes 

perforées, où le texte à composer 
était parsemé de commandes 
destinées à la manoeuvre de la Lynotype 
el 1 e même (passer en gras, 
changer de corps, faire un retrait, etc.). 

</LI> 
</UL> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100%" hei ght="2%" B0RDER="0" 
CELLSPACING="0" BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t">Ph . Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Comprendre XML et XSL</TD> 
<TD width="33%" al ign="right">4</TD> 
</TR> 
</TABLE> 
</B0DY> 
</HTML> 

II peutetre aussi interessant de voir le fichier Table. html, pour le comparer aux regies 
qui I'ontcree. 

Table.html 

<HTML> 
<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<TABLE valign="top" width="100%" hei ght="2%" B0RDER="0" CELLSPACING="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33r al i gn="l ef t"XA HREF="XML.l.html"> 
Page précédente</AX/TD> 

<TD width="34%" al ign="center"XA HREF="Table.html">Table</A> 
</TD> 

<TD width="33%" al ign="right"XA HREF="XML.2.html"> 
Page suivante</AX/TD> 
</TR> 
</TABLE> 

<TABLE width="100r height="90%" B0RDER="0" CELLSPACING="10"> 
<TR val ign="top"> 
<TD> 

<H1 align="left"XA HREF="XML.l.htral">Déroulement du 
Cours</AX/Hl> 
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<H1 align="left"XA HREF="XML.2.html"> 
XML - Généralités </AX/Hl> 
<H2 align="left"XA HREF="XML.2. html "> Balisage </AX/H2> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100r hei ght="2%" B0RDER="0" CELLSPACING="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t">Ph . Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Comprendre XML et XSL</TD> 
<TD width="33%" align="right">3</TD> 
</TR> 
</TABLE> 
</B0DY> 
</HTML> 
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Transformation XML - RTF 



Je presente ici une realisation reel I e, eel le qui a permis la production technique de ce 
livre. J'avais commence, auparavant, la redaction d'un support de cours de formation 
XML etXSLT pour ma societe. Ce support etait lui-meme au formatXML, carl'un des 
objectifs etait de pouvoir realiser cette source sous differents formats, notamment un for- 
mat imprimablede haute qualite, et un format video-projetable. Le format imprimablede 
haute qualite etait produit par une transformation XSLT donnant un source Latex (lui- 
meme a compiler pour produire un fichier imprimable), et le format video-projetable par 
une autre transformation XSLT donnant du HTML. 



Note 

A I'epoque, la solution passant par du XSL-FO donnant du PDF a I'arrivee n 'eta it pas envisageable, car il n'y 
avait pas encore de processeurs FO disponibles, alors que les compilateurs Latex existent depuis de tres 
nombreuses annees. 

Puis I 'idee m'est venue que ce document pourrait faire I'objet d'un livre, et j'ai com- 
mence a reprendre la redaction en consequence. Mais j'ai conserve le format source 
XML, afin de rester independant des technologies proprietaires, quel I es qu'elles soient. 
Mon idee etait de peaufiner la transformation XSLT produisant du Latex, car il reste 
effectivement tres difficile de surpasser le resultat d'une compilation Latex, en ce qui 
concerne I 'aspect prof essionnel etesthetique del 'impression finale. 

Mais, apres avoir finalement signe un contrat d'edition avec la societe Eyrolles, il a 
fallu s'adapter a une chainede production partant d'un fichier source au format M icro- 
soft Word : I'auteur est en effet cense fournir au final un document Word, stylise sui- 
vant une feuille de style fournie par Eyrolles. Ce document Word est le point de depart 
de la chainede production : il est sauvegarde au formatRTF (le format texte capable de 
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sauvegarder sans perte de styles le contenu d'un document Word), puis repris sous 
FrameM aker avec un certain nombrede macros permettant d'automatiser au maximum 
la mise en page. 

Partantd'un documentXM L, il n'y avaitquedeux solutions pourfournir un fichier Word 
(ou RTF, cequi revientau meme) : 

• soit reprendrea la main la source XM L, I'injecter petit a petit par copier-col ler dans un 
document Word, et appliquer au fur et a mesure les styles adequats ; 

• soit tenter d'obtenir automatiquement un fichier RTF correctement stylise a parti r de la 
source XM L. 

La premiere solution demande un travail long, fastidieux, et sans interet. 

La deuxieme solution consiste a ecri re une feuille de style XSLT qui produisedu RTF a 
partir d'un document XM L exprimant la structure et la semantique d'un texte ; mais la 
difficult^ essenti el I e, en tout cas pour moi, est la meconnaissance du format RTF lui- 
meme. 

Etant donne les delais impartis, il m'etait impossible de me mettre a apprendre RTF ; je 
me suis alors rabattu sur une solution de fortune, mais qui s'est revelee final ement tres 
fiable et assez simple a mettre en oeuvre. J 'ai redige sous Word un texte d'une page ou 
deux, comportanttous les styles possiblesfournis par Eyrolles, texte que j'ai sauvegarde 
au format RTF. II m'aensuitesuffitdereperer les sequences RTF propresachaquestyle 
Word, et deles injecter dans chacunedes regies XSLT correspondantes. J 'ai ainsi obtenu 
a peu de frais un generateur RTF, non universel, il est vrai, puisqu'entierement lie a la 
DTD adoptee pour le document X M L, mais capable de transformer toute instance XML 
decetteDTD en un fichier RTF ayant I 'aspect attendu lorsqu'on I'ouvre sous Word. 

C'est cette solution que j'ai done retenue pour la production finale du document RTF a 
fournir a I'editeur. 



Structure du document source XML 

La structure du document XML (ou DTD) a ete determined avant d'avoir a resoudre le 
probleme de la transformation en RTF. Cette DTD a largement ete influenced par deux 
idees directrices : d'une part eviter les structures fortement hierarchiques, et d'autre part 
faciliter la transformation XSLT produisant du HTM L et du Latex, puisque e'etait au 
depart les deux langages-cibles envisages. 

La premiere contrainte etait motivee par la volonte de ne pas etre tributaire d'un editeur 
XML dedie, maisau contrairedepouvoir utiliser un editeur detextes general iste, comme 
BBEdit sous M acOS, UltraEdit sous Windows, ou XEmacs sous Unix ou Windows. Or 
une DTD comme eel le de DocBook, par exemple (voir Exemple, page 385), estextreme- 
ment penible a utiliser sans editeur XML specialise, a cause de la grande distance qui 
peut separer une balise ouvrante de la balise fermante correspondante, et du degre el eve 
d'imbrication des elements les uns dans les autres. Cela rend les modifications de 
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structure du document (par exemplepermuter deux sections, passer une section deniveau 
2 en niveau 3, ou I'inverse, etc.) inextricables a realiser sans un outil capable de manipuler 
global ement un element et toute sa descendance. 

La deuxieme contrainte demande a ce que grosso-modo, chaque balise X M L utilisee ait 
son equivalent en Latex et en HTML, c'est-a-dire qu'il n'y ait pas de fosse structurel 
entre le document source XM L et les documents resultats en HTM L ou Latex. En fait il 
se trouve que Latex et HTM L sont deux langages de balises qui peuvent etre assez voi- 
sins structurel I ement, dans la mesure ou le principal, c'est le texte au kilometre (avec 
eventuellement un regroupement de phrases par paragraphe), parseme de balises indi- 
quant un titre de section niveau 1, 2, 3, etc. 

Or, il se trouve que RTF estlui aussi un langagede balises assez peu tourne vers I 'imbri- 
cation des structures mises en oeuvre. 

Nous avons done conserve a peu pres la DTD d'origine, en I'augmentantd'elements sup- 
plemental provenant de la description des styles Word fournis par les editions Eyrol- 
les. Cette DTD, conformement aux deux contraintes indiquees ci-dessus, evite au 
maximum toute imbrication structurelle d'elements de type « bloc de texte » ; les seuls 
blocs structurants sont les paragraphes, les remarques, les listings de diverses sortes, les 
figures, les listes et les tableaux, mais ces elements sont uniquement juxtaposables (pas 
d'imbrication possible). 

Bien stir, des elements peuvent apparaitre dans un paragraphe, par exemple, (pour mar- 
quer un fragment de code dans du texte courant, ou pour indiquer des mots importants, 
ou des renvois vers d'autres parties du document, etc.), mais ces elements ne sont pas des 
blocs en ce sens qu'ils n'ont aucun enfant direct. 

Par exemple, le texte XM L aux environs de la section Instruction xsl: import, page 381 
est balise ainsi : 

<!-- 

************************************************************************** 
--> 

<titre2 id="include. titre. 10. Decoupe" indexWords="l,2">Instruction xsl : import</titre2> 



<!-- 

************************************************************************** 
--> 

<titre3 id="importSyntaxe. titre. 11 . Decoupe" >Syntaxe</titre3> 



<ti treCode>xsl : import</titreCode> 

<1 istingAvecTi tre><! [CDATA[<xsl : import 

href=" ..." 
/>]]></! istingAvecTitre> 
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<paragraphe>L'attribut href <tresImportant> ne doit pas </tresImportant> etre un 

descripteur de valeur differee. 
</paragraphe> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl : import 
</codeDansTexte> doit apparaitre comme instruction de premier niveau, et de plus 
doit apparaitre avant toute autre instruction. 

</paragraphe> 



<!-- 

************************************************************************** 
--> 

<titre3 id="importSemantique.titre.l2.Decoupe"> Semantique</titre3> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl:import 
</codeDansTexte> permet d'incorporer au fichier source XSLT courant les 
instructions XSLT d'un autre fichier source XSLT dont l'URI est fourni par 
1'attribut <codeDansTexte avant=" " >href</codeDansTexte>. La difference avec 
<codeDansTexte avant=" " apres=" ">xsl :include</codeDansTexte> tient a ce que les 
conflits, en cas de definitions multiples d'une meme instruction XSLT, ne sont pas 
necessai rement des cas d'erreurs, et peuvent etre resolus grace a des regies 
specifiques. 

</paragraphe> 



<!-- 

************************************************************************** 
--> 

<titre4 id="importSemantiqueproc.titre.l3.Decoupe"> Processus mis en oeuvre</titre4> 

<index indexWords="l,4,5">Instanciation de 1 'instruction xsl :import</index> 

<index indexWords="l,3,7,8">Detection de conflits dus a 1 'instruction xsl:import 
</index> 

<index indexWords="l,4,9">Calcul de la preseance des feuilles importees par 
xsl :import</index> 

<paragraphe>Le processus d'incorporation des instructions XSLT provenant d'une 
feuille de style importee est le meme que dans le cas d'une inclusion (voir 
<renvoiVersTitre i dRef =" i ncl udeSemantiqueproc.titre.5.Decoupe" avant=" " />). Ce 
qui change, c'est 1 'interpretation du resultat une fois 1 'incorporation terminee. 
On peut exprimer cela assez facilement sur un dessin (voir <renvoiVersFigure 
idRef="include-import.fig.l.Decoupe" avant=" " />, ou <italiques> A</italiques>, 
<italiques> B</italiques>, <italiques> C</italiques>, et <italiques> D 
</italiques> representent des instructions XSLT quelconques) : dans le cas d'une 
inclusion, la double presence de 1 'instruction <italiques> B </italiques> pose (en 
general) probleme; mais dans le cas d'une importation, ell e ne pose pas probleme. 

</paragraphe> 
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<figure id="incl ude-import.fig.l.Decoupe" dir=" images/ I nstructionsDecoupage 
file="i nclude-import.eps" legende='Comparaison inclusion-importation'/) 



<remarque titre="Note">La <renvoiVersFigure idRef="include-import.fig.l.Decoupe" 
avant=" " apres=" " /> suggere un conflit potentiel entre 1 'element <italiques> B 
</italiques> de la feuille principale et 1 'element <italiques> B </italiques> de 
la feuille importee. Neanmoins, il faut garder a 1 'esprit qu'une stricte identite 
d'element n'est pas necessaire a 1 'apparition d'un conflit : deux regies de 
transformation de motifs differents peuvent tres bien engendrer un conflit sur un 
certain nsud, si les deux motifs concordent simul tanement avec ce nceud. La figure 
est ici un support visuel qui permet de mettre en evidence les endroits ou l'on 
discute d'un conflit, mais el 1 e ne doit pas faire croire que les conflits ne 
peuvent pas surgir ailleurs. 

</remarque> 



M algre un aspect un peu rebarbatif a la lecture, ce genre de texte est tres rapide a taper 
sous un editeur detextes comme UltraEdit, XEmacs ou BBEdit, parce que chaque bali- 
sage peut etre realise par appel d'une macro adequate, apres avoir selectionne le ou les 
mots a baliser. La transformation XSLT d'un chapitre est tres rapide (5 secondes pour 
obtenir 100 pages de document final Word avec Saxon, sur un PC portable PHI), ce qui 
permet de control er tres souvent (sous Word) le rendu du resultatobtenu. 

Description de la DTD utilisee 

La DTD reprend les idees exprimees plus haut, en evitant au maximum les possibilites 
d'imbrication. Certaines limitations proviennent de la feuille de style Word fournie par 
les editions Eyrolles ; parexemple, il n'y a que deux niveaux de listes a puces, probable- 
ment parcequ'il neserait pas raisonnable, d'un pointdevueredactionnel, d'aller au del a. 

xml -rtf .dtd 

<?xml version='1.0' encoding='UTF-16' ?> 



<!-- [ 



DTD pour la traduction RTF de documents XML 

Chaque < ! ELEMENT ... > correspond a un style de feuille de style RTF. 



--> 



<i-- ================================================== 

<!-- Entites definissant des raccourcis d'ecriture dans 



> 



les definitions d'elements ou d'attributs --> 
<i-- ============================================= 



> 



< ! ENTITY % fragmentDeTexte "#PCDATA | subtil | italiques | titreOeuvre | 

treslmportant | codeDansTexte | 
codeRTFDansTexte | 
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renvoiVersTableau | renvoiVersFigure | 
renvoi VersTitre | espace | 
br | refBiblio 



> 



<! ENTITY % fragmentDeTexteAvecNoteBP "#PCDATA | subtil | italiques | 



< ! ENTITY % elementDeListing "#PCDATA | pseudocode | codeFaux 

" > 

<!-- definition des elements associes --> 



<! ELEMENT subtil (#PCDATA) > 
<! ELEMENT italiques (#PCDATA) > 

<! ELEMENT titreOeuvre (#PCDATA) > 

<! ELEMENT treslmportant (#PCDATA) > 

<! ELEMENT codeDansTexte (#PCDATA)> 

<!ATTLIST codeDansTexte avant CDATA ^IMPLIED > 

<!ATTLIST codeDansTexte apres CDATA ^IMPLIED > 

<! ELEMENT codeRTFDansTexte (#PCDATA)> 

<!ATTLIST codeRTFDansTexte avant CDATA #IMPLIED > 

<!ATTLIST codeRTFDansTexte apres CDATA ^IMPLIED > 

<! ELEMENT pseudocode (#PCDATA)> 

<! ELEMENT codeFaux (#PCDATA)> 

<! ELEMENT renvoiVersFigure (#PCDATA)> 

<!ATTLIST renvoiVersFigure idRef IDREF #REQU I RED > 

<!ATTLIST renvoiVersFigure avant CDATA ^IMPLIED > 

OATTLIST renvoiVersFigure apres CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre postlt CDATA ^IMPLIED > 

<! ELEMENT renvoiVersTitre (#PCDATA)> 

<!ATTLIST renvoiVersTitre idRef IDREF #REQUIRED > 

<!ATTLIST renvoiVersTitre avant CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre apres CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre postlt CDATA #IMPLIED > 



titreOeuvre | treslmportant | 
codeDansTexte | codeRTFDansTexte 
renvoiVersTableau | 
renvoiVersFigure | 
renvoiVersTitre | espace | 
br | noteBP | refBiblio 



> 



<!-- 



--> 
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< ! ELEMENT renvoi VersTabl eau (#PCDATA)> 
<!ATTLIST renvoiVersTableau idRef IDREF ^REQUIRED > 
<!ATTLIST renvoiVersTableau avant CDATA //IMPLIED > 
<!ATTLIST renvoiVersTableau apres CDATA //IMPLIED > 
<!ATTLIST renvoiVersTitre postlt CDATA //IMPLIED > 



< ! ELEMENT refBiblio (#PCDATA)> 

<!ATTLIST refBiblio idRef IDREF //REQUIRED > 

< ! ELEMENT index (//PCDATA)> 

<!ATTLIST index indexWords CDATA //IMPLIED > 

< ! ELEMENT espace EMPTY > 

<! ELEMENT br EMPTY > 

< ! ELEMENT aerati onVerti cal e EMPTY > 



< ! ENTITY % blocDeTexte "partie | titreChapitre | titreAnnexe 
titre2 | titre3 | titre4 | titre5 | 
paragraphe | tableau | remarque | 
figure | listing | listingRTF | 
listingPseudoCode | 
codeLlneLigne | aerationVerticale | 
fichier | liste | listeANumero | 
ligneCodeAvecCommentaire | 
commentai reLigneDeCode | index | 
titreCode | listingAvecTitre | 
sousTitreCommentai re | 
exemplePourSousTi treDeCommentai re 
" > 

< ! ENTITY % titre.attributs "id ID //REQUIRED 

numero CDATA //IMPLIED 
indexWords CDATA //IMPLIED 
"> 

<!-- definition des elements associes --> 
<i > 

< ! ELEMENT partie (JJfragmentDeTexte; )* > 
<!ATTLIST partie ^titre.attributs; > 

< ! ELEMENT titreChapitre (%f ragmentDeTexte; )* > 
<!ATTLIST titreChapitre ^titre.attributs; > 



< ! ELEMENT titreAnnexe UfragmentDeTexte; )* > 
<!ATTLIST titreAnnexe %titre.attributs; > 
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<! ELEMENT titre2 (%f ragmentDeTexteAvecNoteBP; )* > 
<!ATTLIST titre2 %titre.attributs; > 



<! ELEMENT titre3 (%f ragmentDeTexteAvecNoteBP; )* > 

<!ATTLIST titre3 Ititre.attributs; > 

<! ELEMENT titre4 Uf ragmentDeTexteAvecNoteBP ; )* > 

<!ATTLIST titre4 %titre.attributs; > 

<! ELEMENT titre5 UfragmentDeTexteAvecNoteBP; )* > 

<!ATTLIST titre5 Ztitre.attributs; > 

<! ELEMENT paragraphe UfragmentDeTexteAvecNoteBP; | index)* > 

<! ELEMENT noteBP UfragmentDeTexte; )* > 



<! ELEMENT remarque Uf ragmentDeTexteAvecNoteBP; | index)* > 
<!ATTLIST remarque id ID #REQU I RED 

titre CDATA #REQUIRED 

> 



<! ELEMENT figure EMPTY 
<!ATTLIST figure 



> 

id 
di r 
file 
1 egende 



ID ^REQUIRED 
CDATA ^IMPLIED 
CDATA ^REQUIRED 
CDATA ^REQUIRED 



<! ELEMENT listing (%el ementDeLi sting;)* > 

<! ELEMENT listingRTF UelementDeListing; )* > 

<! ELEMENT 1 i sti ngAvecTi tre UelementDeListing; )* > 

<! ELEMENT 1 i sti ngPseudoCode (%elementDeListing; )* > 

<! ELEMENT codeUneLigne (#PCDATA) > 

<! ELEMENT fichier EMPTY > 

<!ATTLIST fichier nom CDATA #REQUI RED > 



<! ELEMENT 1 i gneCodeAvecCommentai re (#PCDATA) > 

< ! ELEMENT commentai reLi gneDeCode (%f ragmentDeTexteAvecNoteBP; )* > 



<! ELEMENT titreCode (#PCDATA) > 



<! ELEMENT sousTitreCommentai re (#PCDATA) > 

<! ELEMENT exempl ePourSousTi treDeCommentai re (#PCDATA) > 

<! ELEMENT listeANumero ( item | liste2 )+ > 
< ! ELEMENT liste ( item | liste2 )+ > 
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< ! ELEMENT listeZ ( item )+ > 

< ! ELEMENT item (%f ragmentDeTexteAvecNoteBP ; )* > 

<!ATTLIST item no CDATA ^IMPLIED > 



< ! ELEMENT tableau 
<!ATTLIST tableau 



( legende?, titresCol onnes , 
id ID //IMPLIED > 



lignes+ ) > 



< ! ELEMENT tabl eauSansTi tresCol onnes ( legende?, 
<!ATTLIST tableauSansTitresColonnes id ID 



< ! ELEMENT ti tresCol onnes 
< ! ELEMENT lignes 



ignes+ ) > 
#IMPLIED > 



)* > 



( cellule [ nouvelleCellule 
( cellule | nouvelleCellule | 
nouvelleLigne )* > 
< ! ELEMENT legende (%f ragmentDeTexte; )* > 
< ! ELEMENT cellule (%f ragmentDeTexteAvecNoteBP; | celbr)* 
< ! ELEMENT nouvelleCellule EMPTY > 
< ! ELEMENT nouvelleLigne EMPTY > 
< ! ELEMENT celbr EMPTY > 



<j— ================================================================== -_> 

<i— ========================= --> 

<!-- Qu'est-ce qu'un livre ? --> 
<i— ========================= --> 

< ! ELEMENT livre ( partie | chapitre )* > 
<!ELEMENT chapitre UblocDeTexte; )* > 

<i— ================== -_> 

<!-- fin --> 

<!-- ] --> 



Transformation XSLT 

II y a en gros trois sortes de model esde transformation a mettre au point : 

• Ceux qui sont specifiquement dedies a la traduction RTF d'un element XML refletant 
un style Word ; par exemple, la traduction en RTF de I 'element <codeDansTexte>. 

• Ceux qui sont lies a la presence de caracteres speciaux en RTF, qu'il s'agit dedetecter 
et d'envelopper de telle sorte qu'ils redeviennent non significatifs ; par exemple, le 
backslash - v ou les accolades ■{}■. 
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• Ceux qui realisent un traitement independant du langage cible, comme par exemple 
certains traitements purement algorithmiques intervenant dans la creation des entrees 
d'index. 

L'ensemble de ces regies et model es nommes n'est pas tout a fait complet, car il ne donne 
que la generation du corps de document RTF proprement dit ; celle du prologue RTF est 
assuree par une regie unique et specifique. 

Prologue 

Un document RTF est constitue d'un prologue et d'un corps de document ; lorsqu'il est 
genere par Word, le prologue est un texteassez volumineux de 35000 caracteres envi ron ; 
c'est la regie X SLT de traitement de la racine du document X M L qui est chargee de generer 
ce prologue : 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xml ns :saxon="http: //icl .com/saxon" 

extension -el ement-pref ixes="saxon" 

version = "1.0"> 



<xsl :strip-space el ements="*"/> 

<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl : tempi ate match='/'> 
<xsl :text> 

<xsl :text>{\rtfl\ansi\ansicpgl252\ucl \deff0\deflangl036\deflangfel036 

{\fonttbl {\f0\froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New 
Roman ; }{\f l\fswi ss\fcharset0\fprq2(\*\panose 020b0604020202020204}Ari al ; } 
{\f2\fmodern\fcharset0\fprql{\*\panose 02070309020205020404}Courier New;}{\f3\ 
froman\fcharset2\fprq2(\*\panose 05050102010706020507 (Symbol ; } {\f4\f roman\ 
fcharset0\fprq2{\*\panose 02020603050405020304}Times ; } 
{\fl4\fnil\fcharset2\fprq2{\*\panose 05000000000000000000}Wingdings;}{\f28\fswiss\ 
fcharset0\fprq2{\*\panose 020b0506020202030204}Ari al Narrow;} 

. . . etc . . . 

{\field{\*\fldinst {\b SECTIONPAGES \\* MERGEFORMAT }}{\fldrslt {\b\langl024\ 
1 angfel024\noproof 5}} } {\par } } {\*\pnsecl vl l\pnucrm\pnstartl\pnindent720\pnhang 
(\pntxta . } } {\*\pnsecl vl2\pnucl tr\pnstartl\pnindent720\pnhang{\pntxta . } } {\*\ 
pnsecl vl3\pndec\pnstartl\pnindent720\pnhang{\pntxta . } } {\*\pnsecl vl4\pnl cl tr\ 
pnstartl\pnindent720\pnhang{\pntxta ) } } 

{\*\pnsecl vl 5\pndec\pnstartl\pnindent720\pnhang{\pntxtb ( } {\pntxta ) } } {\*\pnsecl vl 6\ 
pnl cl tr\pnstartl\pnindent720\pnhang{\pntxtb ( } (\pntxta )} } {\*\pnsecl vl7\pnl crm\ 
pnstartl\pnindent720\pnhang{\pntxtb ( } {\pntxta )} } {\*\pnsecl vl8\pnl cl tr\pnstartl\ 
pnindent720\pnhang{\pntxtb ( }{\pntxta ) } ( {\*\pnsecl vl 9\pnl crm\pnstartl\ 
pnindent720\pnhang{\pntxtb (}{\pntxta )}} 

</xsl :text> 
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</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :apply-templates/> 

} 



</xsl : tempi ate> 



Note 

D'une maniere genera le, le code RTF genereparWord, etrepris tel quel dans les regies de transformation XSLT 
mises au point, est d'une grande verbosite (ou complexity ?), si on le compare a des fichiers RTF obtenus par 
d'autres moyens. Le but etant de pouvoirouvrirle document obtenu sous Word, il ne m'a pas semble utile de 
chercher a simplifier quoi que ce soit. 



Regies pour la transcription RTF d'un style 

Les regies les plus simples sont celles associees a des elements qui ne sont ni la cible de 
renvois, ni associes a des entrees d'index. Par exemple : 

<! — 

==== subtil ====== 

--> 

<xsl :template match='subtil '> 

<xsl :text>{\cs59\i </xsl:text> 

<xsl :apply-templates mode='noTrim'/> 

<xsl :text>}</xsl :text> 
</xsl : tempi ate> 

<! — 

==== italiques ====== 

--> 

<xsl :template match='italiques'> 

<xsl :text>{\i </xsl :text> 

<xsl :apply-templates mode='noTrim'/> 

<xsl :text>}</xsl :text> 
</xsl : tempi ate> 

<! — 

==== pseudocode ====== 

--> 

<xsl :template match='pseudoCode' mode='listing'> 

<xsl :text>{\cs78\i </xsl:text> 

<xsl :apply-templates mode='listing'/> 

<xsl :text>}</xsl :text> 
</xsl : tempi ate> 



<!-- 
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==== titreOeuvre ====== 

--> 

<xsl :template match='titreOeuvre'> 

<xsl :text>{\cs62\i </xsl:text> 

<xsl :apply-templates mode='noTriin'/> 

<xsl :text>}</xsl :text> 
</xsl :templ ate> 

<! — 

==== tres important === 

--> 

<xsl :template match='tresImportant'> 

<xsl :text>{\cs60\b </xsl:text> 

<xsl :apply-templates mode='noTrim'/> 

<xsl :text>}</xsl :text> 
</xsl :templ ate> 

Les regies pour la transformation d'elements qui peuventetre la cible de renvois sont un 
peu plus compliquees, a cause des instructions RTF \bkmkstart et \bkmkend a generer. 

<! — 

==== remarque ========================================= 

--> 

<xsl :templ ate match=' remarque '> 
<xsl :text> 

\pard\pl ain \s40\qj \1 i 1418\ri0\sbl60\widctlpar\txl418\aspalpha\aspnum\faauto\ 
adjustright\rin0\linl418\itap0 \b\f28\fsl8\lang3084\langfel036\cgrid\langnp3084\ 
langfenpl036 { 
{\*\bkmkstart </xsl :text> 

<xsl :val ue-of select="translate( @id, '')"/> 
<xsl :text>}</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :val ue-of select="@titre"/> 
<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :text>{\*\bkmkend </xsl :text> 
<xsl :value-of select="translate( (Sid, '')"/> 
<xsl :text>} 
\par } 

\pard\plain \s39\qj \H1418\riO\sb40\widctlpar 

\txl418\aspalpha\aspnum\faauto\adjustright\rin0\linl418\itap0 \f sl8\l ang3084\ 
Iangfel036\cgrid\langnp3084\langfenpl036{</xsl :text> 
<xsl :apply-templates/> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :text>\par }</xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
</xsl :templ ate> 
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L'appel a la fonction translate, ci-dessus, a lieu dans toutes les regies definissant des 
signets (bookmark) RTF, car RTF n'acceptepas certains caracteres dans les signets, alors 
qu'ils sont autorises en XM L pour former un identi fiant. Par securite, les occurrences 
eventuelles de I'un des 3 caracteres ■ pouvant intervenir dans un i denti fiant X M L 
sont supprimeesdu signet RTF. 

La categorie suivante est eel le des regies associees a des elements qui peuvent etre la 
ci bl e de renvoi s, et conteni r des di recti ves d' entrees d'i ndex : 

<! — 

==== titre niveau 2 ========================================= 

--> 

<xsl : tempi ate match='titre2'> 
<xsl :text> 

\pard\pl ain \s2\ql \1 i0\ri0\sb500\keep\keepn\widctl par\aspal pha\aspnum\f aauto\ 
outlinelevell\adjustright\rinO\linO\itapO \b\f l\fs28\l angl024\l angfel024\cgrid\ 
noproof \1 angnpl036\l angfenpl036 

{ 

{\*\bkmkstart </xsl :text> 

<xsl :val ue-of sel ect="transl ate( @id, ")"/> 
<xsl :text>}</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :apply-templates/> 

<xsl :cal 1 - tempi ate name="instancier-sautDel_igne"/> 
<xsl :text>{\*\bkmkend </xsl :text> 
<xsl :val ue-of sel ect="transl ate( @id, '')"/> 
<xsl :text>}</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl:if test="@indexWords"> 

<xsl :call-template name="instancier-XEntries"> 

<xsl :with-param name="l istOfNumbers" select="@indexWords"/> 
<xsl :wi th-param name="stringToSpl i t" sel ect= "normal ize-space( . ) "/> 
</xsl :call-template> 
</xsl :if> 

<xsl :cal 1 - tempi ate name="instancier-sautDel_igne"/> 
<xsl :text>\par }</xsl:text> 

<xsl :cal 1 - tempi ate name="instancier-sautDel_igne"/> 
</xsl : tempi ate> 

Le modele nomme instancier-xEntries permet de generer les entrees d'index. Par 
exemple, avec le titre suivant : 

<!-- 

*************************************************************************** 
--> 

<titre4 id="importSemantiqueinter. titre. 14. Decoupe" indexWords="l,4,5"> Interet 
de 1 'instruction xsl : import</titre4> 
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on aura les entrees d'index suivantes : 

{\xe \v{Interet de 1 'instruction xsl :import}} 
{\xe \v{instruction xsl:import (Interet de 1')}} 
{\xe \v{xsl : import (Interet de 1 'instruction )}} 

En effet, I'attribut indexWords donne les numeros de mots du titre qui doivent setrouver 
places en premier dans chaque entree d'index. Seuls les caracteres apostrophe et espace 
sont separateurs de mots, xsi : import est done considers comme un seul mot. 

Regies pour rendre inoffensifs certains caracteres en RTF 

Ces regies concernentsurtout la facon de rendre un texte non balise, pouvantcontenir des 
caracteres anodins en X M L, mais significatifs en RTF. 



<!- 



=== text 

-> 



<xsl rtempl ate match='text() '> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl :with-param name="texte" select="normal ize-space( . ) " /> 

</xsl :call-template> 
</xsl itempl ate> 

<!--> 



<!--> 



<xsl :templ ate match='text() ' mode='noTrim'> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl iwith-param name="texte" select="." /> 

</xsl :call-template> 
</xsl itempl ate> 



<!--> 
<!--> 



<xsl itemplate match='text( ) ' mode='listing'> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-RTFpar-et-escape-accolades"> 
<xsl :with-param name="texte" select="translate( .,'«»', '<>' )" /> 

</xsl :call-template> 
</xsl itempl ate> 



<!--> 



<!--> 
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<xsl : tempi ate match='text( ) ' mode='listingRTF'> 
<xsl :cal 1 -tempi ate 

name="instancier-texteAvec-RTFpar-et-escape-accol ades-et-backsl ash"> 

<xsl :with-param name="texte" sel ect="transl ate( .,'«»', '<>' )" /> 
</xsl :call-template> 
</xsl : tempi ate> 



<!--> 



<!--> 

<xsl :template name="instancier-texteAvec-escape-accolades"> 
<xsl:param name="texte" /> 

<xsl :variable name="codeSource2"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec -escape- accol ades-gauches"> 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl : cal 1 -tempi ate> 
</xsl :variable> 

<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades-droites"> 
<xsl :with-param name="codeSource" select="$codeSource2" /> 

</xsl :cal 1 -tempi ate> 
</xsl :variable> 

<xsl :copy-of sel ect="$codeSource3"/> 
</xsl : tempi ate> 



<!--> 



<!--> 

<xsl : tempi ate name='instancier-texteAvec-RTFpar-et-escape-accolades'> 
<xsl:param name="texte" /> 

<xsl :variable name="codeSourcel"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-RTFpar"> 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl : cal 1 -tempi ate> 
</xsl :variable> 



<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl :with-param name="texte" select="$codeSourcel" /> 

</xsl :cal 1 -tempi ate> 
</xsl :variable> 
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<xsl :copy-of select="$codeSource3"/> 
</xsl :templ ate> 



<!--> 



<!--> 
<xsl : tempi ate 

name=' instancier-texteAvec-RTFpar-et-escape-accol ades-et-backsl ash' > 
<xsl:param name="texte" /> 

<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-backsl ash"> 
<xsl :with-param name="codeSource" sel ect="$texte" /> 

</xsl :call-template> 
</xsl :variable> 

<xsl :variable name="codeSourcel n > 
<xsl :call-template 

name="instancier-texteAvec-RTFpar-et-escape-accol ades"> 

<xsl :with-param name="texte" select="$codeSource3" /> 
</xsl :call -template> 
</xsl :variable> 

<xsl :copy-of sel ect="$codeSourcel"/> 
</xsl :templ ate> 



<!--> 



<!--> 



<xsl rtemplate name="instancier-texteAvec-RTFpar"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '
' )"> 

<xsl : val ue-of select="substring-before( ScodeSource, '
' )" /> 
<xsl :cal 1 - tempi ate name="instancier-sautDeLigne'7> 
<xsl :text>\par </xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-RTFpar"> 
<xsl :with-param name="codeSource" 

select="substring-after($codeSource, '
 ' )"/> 

</xsl :call-template> 
</xsl :when> 



<xsl :otherwise> 
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<xsl :val ue-of sel ect="$codeSource" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl : tempi ate> 

<!--> 

<!--> 

<xsl :template name="instancier-texteAvec-escape-backslash"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '\' )"> 

<xsl : val ue-of sel ect="substring-before( ScodeSource, '\' )" /> 
<xsl :text>\\</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-backsl ash"> 
<xsl :with-param name="codeSource" 

select="substring-after($codeSource, '\' )" /> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of select="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl : tempi ate> 

<!--> 

<!--> 

<xsl : tempi ate name="instancier-texteAvec-escape-accol ades-gauches"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '{' )"> 

<xsl : val ue-of sel ect="substring-before( ScodeSource, '{' )" /> 
<xsl :text>\{</xsl :text> 
<xsl :cal 1 -tempi ate 

name="instancier-texteAvec-escape-accol ades-gauches"> 
<xsl :with-param name="codeSource" 

select="substring-after($codeSource, '{' )" /> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of select="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl : tempi ate> 
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<!--> 



<!--> 

<xsl : tempi ate name="instancier-texteAvec-escape-accol ades-droites"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '}' )"> 

<xsl :value-of select="substring-before( ScodeSource, '}' )" /> 
<xsl :text>\)</xsl :text> 
<xsl : call -tempi ate 

name="instancier-texteAvec-escape-accol ades-droites"> 
<xsl :with-param name="codeSource" 

sel ect=" substring-after (ScodeSource, '}')"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of select="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :templ ate> 

<!--> 



<!--> 

<xsl :template name="instancier-sautDel_igne"> 

<xsl :text> 
</xsl :text> 
</xsl :templ ate> 

On notera que certains modeles nommes sont recursifs (instancier-texteAvec-escape- 
accoi ades-droi tes par exemple), mais tous sont sur le model e d'une recursion terminal e. 



Entrees d'index 

La generation des entrees d'index est la partie la plus complexe de la transformation, 
mais la difficulte est algorithmique, et independante du choix du langage cible RTF. II 
s'agit, a partir d'une chaine de caracteres et d'une liste de numeros de mots, de produire 
di verses permutations de mots dans la chaine de caracteres initial e. 

Par exemple, avec la chaine « detection de conflits dus a ^instruction xsl :import » et la 
liste de numeros de mots « 1,3,7,8 », il faut produire les permutations (les separateurs de 
mots sont I 'apostrophe et I 'espace ) : 

• detection de conflits dus a I 'instruction xskimport 

• conflits dus a I 'instruction xskimport (Detection de) 
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• instruction xsl: import (Detection de conflits dus a I') 

• xskimport (Detection de conflits dus a I 'instruction) 

L'ensemble de ces entrees est produit par le modele nomme instancier-XEntries, qui 
lui-memeappellelemodeleinstancier-xEntry nfois, unefois par numero demot. Cha- 
cun de ces appels produit une permutation, qui est habi I lee de code RTF par le modele 

i nstanci er-i ndexEntry. 

<xsl :template name="instancier-XEntry"> 
<xsl :param name="bl ankNumber"/> 
<xsl :param name="stringToSpl 1t"/> 

<xsl :variable name="before_after"> 

<xsl :cal 1 -tempi ate name="instancier-stringSplits"> 

<xsl :with-param name="bl ankNumber" sel ect="$bl ankNumber"/> 
<xsl :with-param name="stringToSplit" select="$stringToSplit"/> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl :variable name="wordsBefore"> 

<xsl :val ue-of select="$before_after//before" /> 
</xsl :variable> 

<xsl :variable name="wordsBefore-paren"> 

<xsl :choose> 

<xsl :when test="normalize-space($wordsBefore)"> 

(<xsl :value-of select="$wordsBefore" />) 
</xsl :when> 

<xsl : otherwise) 
</xsl :otherwise> 
</xsl :choose> 

</xsl :variable> 

<xsl :variable name="wordsAfter"> 

<xsl :value-of select="$before_after//after" /> 
</xsl :variable> 

<xsl :variable name="theEntry"> 

<xsl :val ue-of sel ect="$wordsAfter"/><xsl :text> </xsl:text> 

<xsl :value-of select="$wordsBefore-paren"/> 
</xsl :variable> 

<xsl :cal 1 -tempi ate name="i nstanci er-indexEntry"> 

<xsl :with-param name="entry" sel ect="$theEntry"/> 
</xsl : call -tempi ate> 

</xsl : tempi ate> 
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<!--> 



<!--> 

<xsl :template name="instancier-XEntries"> 
<xsl :param name="l istOfNumbers"/> 
<xsl :param name="stringToSpl it"/> 

<xsl :choose> 

<xsl :when test="contains($listOfNumbers, ',')"> 

<xsl :variable name="aNumber"> 

<xsl :val ue-of select="substring-before( $1 istOfNumbers, ',')"/> 
</xsl :variable> 

<xsl : cal 1 -tempi ate name="instancier-XEntry"> 

<xsl :with-param name="bl ankNumber" sel ect="$aNumber - l"/> 
<xsl :with-param name="stringToSpl it" select="$stringToSpl it"/> 

</xsl :call-template> 

<xsl : cal 1 -tempi ate name="instancier-XEntries"> 

<xsl :with-param name="l istOfNumbers" 

select="substring-after($listOfNumbers, ' , ' )"/> 

<xsl :with-param name="stringToSpl it" select="$stringToSpl it"/> 
</xsl :call-template> 

</xsl :when> 

<xsl :otherwise> 

<xsl:if test="$l i stOf Numbers"> 

<xsl :choose> 

<xsl:when test="number($l istOfNumbers) = 1"> 

<xsl : cal 1 -tempi ate name="instancier-indexEntry"> 
<xsl :with-param name="entry" 

sel ect="$stringToSpl i t"/> 

</xsl : cal 1 -template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :call-template name="instancier-XEntry"> 
<xsl :with-param name="bl ankNumber" 

sel ect=" number ($1 istOf Numbers )-l"/> 
<xsl :with-param name="stringToSpl it" 

sel ect="$stringToSpl i t"/> 

</xsl :call-template> 
</xsl :otherwise> 
</xsl :choose> 
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</xsl :if> 

</xsl :otherwise> 
</xsl :choose> 



</xsl : tempi ate> 



<!--> 



<!--> 

<xsl :template name="instancier-indexEntry"> 

<xsl:param name="entry"/> 

<xsl :text>{\xe \v{</xsl :text> 

<xsl :val ue-of sel ect= "normal ize-space( Sentry ) "/> 

<xsl :text>}}</xsl :text> 
</xsl : tempi ate> 

<!--> 



<!--> 

<xsl :template match=' index'> 

<xsl :variable name="wordNumbers"> 

<xsl :val ue-of select="@indexWords"/> 
</xsl :variable> 

<xsl :variable name="entries"> 
<xsl :val ue-of select="."/> 
</xsl :variable> 



<xsl :choose> 

<!-- cas ou il y a une liste de numeros de mots --> 
<xsl :when test="normalize-space($wordNumbers)"> 



<xsl : ca 1 1 -tempi ate name="instancier-XEntries"> 

<xsl :with-param name="l istOfNumbers" sel ect="$wordNumbers"/> 
<xsl :with-param name="stringToSplit" 

sel ect=" normal ize-space( Sentries) "/> 

</xsl :cal 1 -tempi ate> 
</xsl :when> 

<!-- cas ou il n'y a pas de liste de numeros de mots : --> 
<!-- le contenu constitue 1 'entree d'index --> 
<xsl :otherwise> 

<xsl :variable name="theEntry"> 
<xsl :apply-templates/> 

</xsl :variable> 
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<xsl :cal 1 -tempi ate name="instancier-indexEntry"> 
<xsl :with-param name="entry" 

sel ect="normal ize-space($theEntry) "/> 

</xsl : call -tempi ate> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 

Etant donne une chaine s composee de mots separes par des apostrophes ou des espaces, 
et un nombre i fournis en donnee, le modele nomme instancier-stn'ngspiits a pour 
but de produire 3 morceaux de chaines de caracteres : la sous-chaine de s situee avant le 
ieme separateur, le separateur, et la sous- chaine de s situee apres le ieme separateur. 

Cette fonction repose sur une definition recursive de la notion «d 'avant et d'apres le 
ieme separateur ». Si on appelle s la chaine donnee, et t la chaine s privee de son pre- 
mier mot, on peut dire que (conformement ace qui estmontre par la figure A- 1) : 

• ce qu'il y a apres le 1 erne separateur dans s, c'est ce qu'il y a apres le i-i erne sepa- 
rateur dans t ; 

• ce qu'il y a avant le i erne separateur dans s, c'est ce qu'il y a avant le i-i erne sepa- 
rateur dans t, concatene au premier mot de s. 

Cette definition vaut pour i superieur a 1 ; lorsque i estegal a 1, c'est un cas trivial, puis- 
que lesfonctionsXSLT predefines substring-beforec ) et substring-after ( ) donnent 
directement I e resultat cherche. 

On notera que la recursion, ici, n'est pas terminal e, a cause de la concatenation a effectuer 
a partir du resultat obtenu recursivement. II serait possible de la rendre terminal e, mais ce 
n'est pas du tout une necessite, car la profondeur de recursion est egale au nombre 
d'entrees a generer pour une meme phrase, qui n'est jamais tres grand (presque toujours 
inferieur a 5). 
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Voici le modele nomme instancier-stringSplits 

<xsl :template name="instancier-stringSplits"> 
<xsl:param name="bl ankNumber"/> 
<xsl : pa ram name="stringToSpl it"/> 
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<xsl :choose> 

<!-- = --> 
<!-- = --> 

<xsl :when test="$bl ankNumber = 1"> 

<xsl :variable name="result"> 
<xsl :call-template 

name="stringSpl i ts-beforeAndAfter-f i rstSeparator"> 

<xsl :with-param name="stringToSplit" 

sel ect="$stringToSpl i t"/> 

</xsl : call -tempi ate> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 

</xsl :when> 

<!-- = --> 
<!-- = --> 

<xsl :when test="$bl ankNumber = 0"> 

<xsl :variable name="result"> 
<split> 

<before/> 
<after> 

<xsl :val ue-of select="$stringToSpl it" /> 
</after> 
</split> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 

</xsl :when> 

<!-- = --> 
<!-- = --> 
<xsl :otherwise> 

<!-- = --> 

<xsl :variable name="before_after"> 
<xsl :cal 1 -tempi ate 

name="stringSpl i ts-beforeAndAfter-f i rstSeparator"> 

<xsl :with-param name="stringToSplit" 

sel ect="$stringToSpl it"/> 

</xsl :cal 1 -tempi ate> 
</xsl :variable> 



<!-- = --> 



Transformation XML - RTF 

Annexe A 



<xsl :vari abl e name="before"> 

<xsl :value-of select="$before_after7/before" /> 
</xsl :variable> 

<!-- = --> 

<xsl :variable name="separator"> 

<xsl :value-of select="$before_after//separator" /> 
</xsl :variable> 

<!-- = --> 

<xsl : vari abl e name="after"> 

<xsl :value-of select="$before_after//after" /> 
</xsl :variable> 

<!-- = --> 

<xsl :variable name="recursive_before_after"> 

<xsl :call -template name="instancier-stringSpl its"> 
<xsl :with-param name="bl ankNumber" 

sel ect="number($bl ankNumber )-l"/> 
<xsl :with-param name="stringToSpl it" select="$after"/> 
</xsl :call -template> 
</xsl :variable> 

<!-- = --> 

<xsl :variable name="result"> 
<split> 

<before> 

<xsl :value-of select="concat( $before, 

Srecursi ve_before_after//before)"/> 

</before> 
<after> 

<xsl :value-of select="$recursive_before_after//after"/> 
</after> 
</split> 
</xsl :variable> 

<!-- = --> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :templ ate> 



Feuille de style complete 

La feuillede style complete, ainsi que la DTD, est disponiblesur le site internet des edi- 
tions Eyrolles : www.editions-eyrolles.com (taper D rix dans leformulaire de recherche rea- 
pide). 



B 



Les instruction menageres 



Les instructions XSLT que nous appelons menageres sontdes instruction qui serventa regler 
quelques parametres pour la lecture de la source X M L ou I 'ecriture du document resultat. 

Cela COnceme les instructions xsl :stylesheet, xsl :namespace-al1as, xsl:output, 
xsl : decimal - format, xsl : preserve- space, etxsl :strip-space. 

Instruction xsl:stylesheet 

Syntaxe 

xsl :sty!esheet 

<xsl :stylesheet 
version="1.0" 

/> 

OU 

xsl :transform 

<xsl :transform 
version="1.0" 

/> 

L'element xsi stylesheet est la racine d'un document XSLT. xsi :transform est un 
synonyme de xsi stylesheet. L'attri but version est obligatoirement egal a 1.0, du 
moinstant que la version 2.0 nesera pas officiellement disponi ble. 

Note 

La version 1.1 ne sera jamais officiellement disponible. 
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Variantes syntaxiques 

xsl : stylesheet 

<xsl :stylesheet 
version="1.0" 

extension -el ement-pref ixes=" " 

excl ude-resul t-pref ixes=" " 

/> 

L a valeur de ces deux attributs facultatifs est fournie sous la forme d'une liste de prefixes 
separes par des espaces blancs. 

A ttribut extension-element-prefixes 

Cet attribut permet au processeurXSLT de distinguer des elements X M L litteraux ains- 
tancier tels quels et des elements XM L qui se trouveraient etre en real ite de nouvelles 
instructions XSLT proposees comme extensions partel outel processeur particulier. Les 
prefixes a fournir doivent bien sfir faire parti e des prefixes declares avec les domaines 
nominaux dans I 'instruction xsi :styiesneet elle-meme. 

Par exemple, I'extension <saxon:entity-ref name="nbsp"/> permet d'emettre dans le 
fichier de sortie la reference a I'entite nbsp propre a HTM L. Pour I'utiliser, il faut done 
declarer le domaine nominal de Saxon, puis le prefixe correspondant (saxon, en I'occur- 
rence) dans la liste des extension-element-prefixes. Ci-dessous un exemple, qui 
reprend I 'exemple vu a la section Realisation avec recherche par expression XPath, 
page 473 : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

xml ns :saxon="http: //icl . com/saxon" 

extension -el ement-pref ixes=" saxon" 

version="1.0"> 

<xsl:output method^'html ' encoding='IS0-8859-l' /> 

<xsl :template match="/"> 
<html> 
<head> 

<title>Programme Saison 
<xsl :value-of 

sel ect=" /Saison /Peri ode "/></title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 
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<xsl : tempi ate match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl :apply-templates sel ect="Adresse"/> 
</xsl :templ ate> 

<xsl :template match="Concert|Theatre"> 

<H3Xxsl :val ue-of sel ect="l ocal -name( . ) "/> </H3> 
<p><saxon : entity- ref name="nbsp"/> 
<saxon : entity- ref name="nbsp"/> 
<saxon : entity- ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
Date : <xsl :value-of sel ect="Date"/> <br/> 
<saxon :entity-ref name="nbsp"/> 
<saxon :entity-ref name="nbsp"/> 
<saxon : entity- ref name="nbsp"/> 
<saxon : entity- ref name="nbsp"/> 
Lieu : <a href="#{generate-id( 

/Saison/Adresse/Lieu 
[ . = current( )/Lieu ])}"> 
<xsl :val ue-of select="Lieu"/> 
</a> 

</p> 
</xsl :templ ate> 

<xsl : tempi ate match="Adresse"> 

<p><a name="#{generate-id( ./Lieu)}"> 
<xsl :value-of select="Lieu"/X/a><br/> 
<xsl :value-of select=" ./child: :text( )[2]"/> 
</p> 

</xsl :templ ate> 

<xsl :template match="text( )"/> 



</xsl :stylesheet> 

Etvoici cequeceladonne: 

Saison.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title>Programme Saison Automne 1999 </title> 
</head> 
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<body bgcolor="white" text="bl ack"> 
<H3>Concert</H3> 
<p>     

Date : Samedi 9 octobre 1999 20H30 <br> 

     

Lieu : <a href="#d0e56">Chapel 1 e des Ursul es</a></p> 
<H3>Théâtre</H3> 
<p>     

Date : Mardi 19 novembre 1999 21H <br> 

     

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Théâtre</H3> 
<p>     

Date : Mercredi 20 novembre 1999 21H30 <br> 

     

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Adresses :</H3> 

<p><a name="#d0e56">Chapelle des Ursules</aXbr> 
9, rue des Ursules - 49000 Angers 

</p> 

<p><a name="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Prévoyants de 1'avenir - 49000 Angers 

</p> 
</body> 
</html> 

Attribut exclude-result-prefixes 

C et attri but demande au processeur de ne pas emettre de decl arati on de domai ne nomi nal 
pour les domaines nominaux references par les prefixes fournis comme valeur de cet 
attribut. 

Comme le processeur XSLT est oblige degenererun document XML correct, il passera 
outre votre demande, si le domaine nominal que vous voulez exclure du resultat est en 
fait utile. M ais si le domaine nominal vise est effectivement inutile dans le document 
genere, votre demande sera prise en compte. Le processeur XSLT ne peut pas deviner 
toutseul si un domaine nominal est vraiment inutile, parcequeXML autorise d'utiliser 
les domaines nominaux meme sur des valeurs d'attribut : 

<truc bidule="machin:chose"> 

II n'est pas interdit d'avoir une valeur d'attribut qui soit "machin:chose" ; dans cette 
chaine de caracteres, "machin" est-il un prefixe, ou simplementle debut d'une valeur ou 
il y a un ":" au milieu ? Si en plus il se trouve que machin est reellement un prefixe 
declare pour un certain domaine nominal, le processeur XSLT ne peut plus s'y retrouver 
poursavoirsi ce domaine nominal est utile ou non. Done les processeurs XSLT n'ontpas 
a decider eux-memes ; e'est a vous de dire lesquels exclure. 
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Instruction xshnamespace-alias 

Syntaxe 

xsl :namespace-al ias 

<xsl :namespace-alias 

styl esheet-pref ix=" ..." 
result-prefix^" ..." 

/> 



instruction xsi :namespace-aiias doit apparaitre comme instruction de premier niveau. 



Semantique 

L'i nstruction xsl :namespace-a lias permetde specifier qu'un element I itteral XML, pre- 
sent dans la feuille de style XSLT, et associe a un domaine nominal Nl, sera instancie 
dans le document resultat comme etant associe a un autre domaine nominal N2. Comme 
d'habitude, lesdomaines nominaux concerned sontdesignes par les prefixes qui les iden- 
tified, cequi rend les choses un peu troubl antes, car on peutcroirequ'il s'agitseulement 
de changer de prefixe (sans changer de domaine nominal), alorsqu'il s'agitbel etbien de 
changer de domaine nominal (et accessoirement de prefixe, mais comme vous le savez, 
un prefixe n'aaucune importance en lui meme). 

Le prefixe du domaine nominal Nl est indique par I ' attri but stylesheet-prefix, et le 
prefixe du domaine nominal N2 par I 'attri but result-prefix, de sorte que ^instruction 
xsi :namespace-ai ias permettant de passer du domaine http://machin (prefixe mm:) au 
domaine http://truc (prefixe tt:) aura I 'allure suivante : 

<xsl :namespace-alias 

styl esheet-pref ix="mm" 
resul t-pref ix="tt"/> 

Ceci ne veut pas du tout dire que les elements litteraux de prefixe mm: apparaitront dans le 
document resultat avec le prefixe tt:, mais que les elements litteraux de domaine nominal 
http://machin apparaitront dans le document resultat associesau domaine nominal http:// 

true. 

Concretement : 
Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 

<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapel 1 e des Ursul es</Lieu> 



<Interpretes> 
<Interprete> 
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<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Interpretes> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 
xml ns :mm="http: //machin" 
xml ns :tt="http: //true" 
version="1.0"> 

<xsl:output method='xml ' encodings' ISO-8859-1' indent='yes' /> 

<xsl :namespace-alias stylesheet-prefix="mm" resul t-pref ix="tt"/> 

<xsl :template match="Interpretes"> 
<mm:Musiciens> 

<xsl :copy-of select="Interprete"/> 
</mm:Musiciens> 
</xsl :template> 

<xsl : tempi ate match="text( ) "></xsl : tempi ate> 
</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mm:Musiciens xml ns:mm="http: //true" xmlns:tt="http://truc"> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viol e</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
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</Interprete> 
</mm:Musiciens> 

Tout cela est assez admirable (plus admirable qu'imitable, d'ailleurs), mais a quoi cela 
peut-il bien servir ? 

L a pri nci pal e uti I i te est de pouvoi r ecri re une f eui 1 1 e de sty I e X S LT qui genere comme resultat 
une autre feui I lede style XSLT. On sereportera a la section Pattern n° 15 -Generation d'une 
feuille de style par une autre feui Me de style, page 507 pour en voir un exemple. 

En effet, si I'on a des instructions XSLT aemettredans le resultat en tant qu'elements I it- 
teraux, il fauttrouver un moyen pour que le processeur XSLT ne les prenne pas pour lui, 
en tant qu'instructions a executer. La solution est de declarer ces instructions dans un 
domaine nominal autre que celui d'XSLT, et de demander a ce que dans le document 
resultat, ces elements apparaissent dans le domaine nominal X SLT. 

Instruction xskfallback 

Syntaxe 

xsl :fal lback 

<xsl :fallback> 

<!-- modele de transformation --> 
</xsl :fallback> 

L'instruction xsi :xsi : fall back ne doit pas apparaitre comme instruction de premier niveau. 

Instruction XSLT typique 

U ne instruction XSLT uti I isant I 'instruction xsl : fail back aura souvent la forme : 

<xsl :xxx> 

<!-- modele de transformation propre a xsl:xxx --> 
<xsl :fallback> 

<!-- modele de transformation propre a xsl:fallback --> 
</xsl :fallback> 
</xsl :xxx> 

L'effet de cette instruction est le suivant : si xsi :xxx est une instruction connue du pro- 
cesseurXSLT, instruction xsi fallback (et ce qu'elle conti ent) estignoree. Si xsi :xxx 
est une instruction inconnue du processeur XSLT, instruction xsi fallback qu'elle 
conti ent est instanciee. 

Cela sert dans lecasou on lance un processeur XSLT 1.0 sur un source XSLT d'une ver- 
sion ulterieure, contenant eventuellement des instructions qui n'existaient pas encore 
dans la 1.0, ou bien dans lecas ou I'on utilise des instructions hors norme (des extensions 
fournies par tel ou tel processeur) dans un programme source qui est susceptible d'etre 
traite par differents processeurs. 
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Instruction xshpreserve-space 

Instruction xshstrip-space 

Syntaxe 



xsl :preserve-space 

<xsl :preserve-space elements^" 



"/> 



xsl :strip-space 

<xsl :strip-space elements=" 



"/> 



Les instructions xsi :preserve-space et xsi : stri p-space doivent apparaitre comme 
instructions de premier niveau. 



^instruction <xsi :stn"p-space> sert a eliminer les noeuds text ne contenant que des 
espaces blancs de I'arbreXM L construit par le processeur XSLT. Voir la section Exem- 
ple, page 170, et la section Realisation avec recherche par expression XPath, page 473. 

L'instruction <xsi :preserve-space> permet de contredire localement instruction 
<xsi :strip-space>. General ement, on nel'emploiepas seule, car son effetestl'effetpar 



Par exemple, pour activer la suppression des noeuds text blancs comme neige, sauf pour 
ceux qui sontdes enfantsde <truc> ou <t>iduie>, on ecrira : 

|<xsl :strip-space el ements="*"/> 
<xsl :preserve-space el ements="truc bidule"/> 



xsl :output 

<xsl :Output 

method ="..." <!-- "xml" | "html" | "text" | name --> 
version = 
encoding = " . . . " 

omit-xml-declaration = <!-- "yes" | "no" --> 

standalone = <!-- "yes" | "no" --> 

doctype-publ i c = <!-- string --> 

doctype-system = <!-- string --> 

cdata-section-elements = " " 

indent = <!-- "yes" | "no" --> 

media-type = <!-- string --> 



Semantique 



defaut. 
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/> 
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Tous les attributs sontfacultatifs. 

L'instruction xsi :output doit apparaitrecomme instruction de premier niveau. 



Semantique 

L'instruction xsi : output permet aux auteurs defeuilles de style de specifier la maniere 
dont Ms souhaitent produire I'arbre resultat. Le processeur doit faire pour le mieux, 
sans etre oblige toutefois de suivre a lettre toutes les directives fournies par les diffe- 
rents attributs. 

LeS attributs principaUX SOnt method, encoding et indent. Notamment I ' attri but method 

estcelui qui est le plus lourd de consequence sur I'aspectdu document resultat. 

L'attri but method identifie la methode general e qui doit etre utilisee pour produire I'arbre 
resultat. Sa valeur doit etre un nom qualifie. S'il n'est pas prefixe, alors il identifie 
I'unedestroissuivantes : xmi, html ou text. Si lenom qualifie est prefixe, alors c'estune 
methode non standard fournie par un processeur parti culier. 

En I'absence d'attri but method, le processeur tente de reconnaitre la nature du fichier 
source; s'il reconnaftdel'HTM L, la methode par defaut sera 'html' ; si non el I e sera 'xmT. 

Lesautres attributs so nt : 

• version : specifie la version de la methode de sortie (par exemple« 1.0 »). 

• indent : demandeou non ('yes' ou 'no') une indentation du fichier de sortie. 

• encoding : specifie I e systeme d'encodage des caracteres du fichier de sortie. 

• media-type : specifie le type MIME du fichier de sortie. 

• doctype-system : specifie I ' i denti fiant systeme qui doit etre utilise dans la declaration 
deDTD. 

• doctype-pubi ic : specifie I ' i denti fiant public qui doit etre utilise dans la declaration 
deDTD. 

• omit-xmi -declaration : demande ou non ('yes' ou 'no') une declaration XML en 
debut de fichier. 

• standalone : specifie la valeur ('yes' ou 'no') de la declaration standalone=« ... » 

• cdata-section-eiements : specifie une liste de noms d'elements dont les fils de type 
text doivent etre produits en tant que section CDATA dans I 'arbre resultat. 

La signification precise de ces attributs en fonction de la methode choisie (text, xmi ou 
html) est tres longue et sans grand interet d'un point de vue general. On se reportera au 
standard XSLT pour tel ou tel detail. 
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Instruction xshdecimal-format 

Syntaxe 

xsl :decimal -format 

<xsl :decimal -format 

name = 

decimal -separator ="..." <!-- char --> 
grouping-separator = <!-- char --> 

infinity = <!-- string --> 

minus-sign = <!-- char --> 

NaN = <!-- string --> 

percent = <!-- char --> 

per-mille = <!-- char --> 

zero-digit = <!-- char --> 

digit = ". . ." <!-- char --> 
pattern-separator = <!-- char --> 

/> 

Tous les attributs sontfacultatifs. 

L'instruction xsl :decimai -format doit apparaitre comme instruction de premier niveau. 
Semantique 

Cette instruction s'utiliseexclusivementavec lafonction format-number( ). Ellen'a rien 
a voir avec instruction xsi number, ni avec la facon dont les conversions de String en 
nombre sont effectuees. II s'agit uniquement ici de format de sortie pour un nombre deja 
calcule par ailleurs. 

L'attri but name permet de declarer un format nomme, qui pourra etre ensuite reference 
dans un appel a la fonction format-number( ), en tant que troisieme argument. Si I'attri- 
but name est omis, ^instruction xsi decimal -format specifie un format par defaut, qui 
pourra ensuite etre reference en appelant la fonction format-numberc ) avec seulement 
deux arguments. 

M is a part l'attri but name, les autres attributs correspondent aux couples demethodes get/ 
set de la classejava Decimal Formatsymbois du J DK 1.1 (une paire par attri but). 

Certains de ces attributs permettent de control er aussi bien I 'interpretation des caracteres 
du motif de format que de specifier ceux qui peuvent apparaitre dans le resultat de forma- 
tagedu nombre: 

• decimal -separator indique le caractere utilise pour marquer un point decimal ; la 
valeur par defaut est I e caractere point ' .'. 

• grouping-separator indique le caractere utilise comme separateur de groupes (par 
exemple milliers) ; la valeur par defaut est la virgule ' ,'. 
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• percent indique le caractere utilise pour le signe pourcent ; la valeur par defaut est le 
caractere pourcent '%'. 

• per-miiie indique le caractere utilise pour le signe pour-mille; la valeur par defaut 
est le caractere U nicode pour-mille (#x203o). 

• zero-digit indique le caractere utilise pour le chiffre zero ; la valeur par defaut est le 
chiffre zero 'o'. 

D'autres control ent I 'interpretation des caracteres dans le motif de format : 

• digit indique le caractere utilise pour un chiffre dans le motif de format ; la valeur 
par defaut est le caractere diese '#'. 

• pattern-separator indique le caractere utilise dans un motif, pour separer les sous- 
motifs representant des nombres positifs des sous motifs representant des nombres 
negatifs ; la valeur par defaut est le caractere point-virgule ' ;'. 

Enfin ceux-ci indiquent les caracteres ou les chaines de caracteres pouvant apparaitre 
dans le resultat de formatage d'un nombre : 

• infinity indique la chaine de caracteres utilisee pour representer I'infini ; la valeur 
par defaut est la chaine de caracteres infinity. 

• NaN indique la chaine de caracteres utilisee pour representer la valeur de NaN (Not a 
Number) ; la valeur par defaut est la chaine de caracteres NaN . 

• minus-sign indique le caractere utilise comme signe moins par defaut ; la valeur par 
defaut est le caractere moins (-, #x2D). 



Exemple 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 



<Concert> 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapel le des Ursul es</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Compositeurs> 

<Composi teur>M. Marais</Composi teur> 

<Composi teur>D. Castel 1 o</Compositeur> 

<Composi teur>F. Rognoni</Composi teur> 

</Compositeurs> 
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<Tarif> 

<plein> 15.0 </plein> 
<reductions> 

<jeune>40</jeune> 
<groupe>30</groupe> 
</reductions> 
</Tarif> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='html ' encodings ISO-8859-1' /> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /Entete"/X/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl : tempi ate match="Date"> 

<H1 al ign="center"> Concert du <xsl :val ue-of select="."/> </Hl> 

<H4 al ign="center"> <xsl : val ue-of select="/Concert/Lieu"/> </H4> 

<H3 al ign="center"> <xsl : val ue-of select="/Concert/TitreConcert"/X/H3> 

</xsl :templ ate> 

<xsl : tempi ate match="l_ieu"> 
</xsl :templ ate> 

<xsl : tempi ate match="Ensemble"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl :decimal -format 
name="prix" 
decimal -separator=" , " 
grouping-separator^" . " /> 

<xsl :templ ate match="Tari f "> 

<xsl :variable name="plein" select="./plein"/> 

<xsl :variable name="reducJeune" select="./reductions/jeune"/> 

<xsl : vari abl e name="reducGroupe" select=" . /reductions /groupe"/> 
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<xsl :variable 
name=" jeune" 

select="$plein - ( $plein * $reducJeune div 100 ) "/> 

<xsl :variable 
name="groupe" 

select="$plein - ( Splein * SreducGroupe div 100 ) "/> 
<P>Tarifs : <br/> 

<xsl :value-of select="format-number( 

$plein, '##,00', 'prix' )"/> Euros <br/> 

<xsl :value-of select="format-number( 

$jeune, '##,00', 'prix' )"/> Euros ( jeunes) ,<br/> 

<xsl :value-of select="format-number( 

Sgroupe, '##,00', 'prix' )"/> Euros (groupes). 

</P> 
</xsl :templ ate> 



</xsl :stylesheet> 

Resultat 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> "Les Concerts d'Anacréon" </title> 
</head> 

<body bgcolor="white" text="bl ack"> 

"Les Concerts d’Anacréon" 

<H1 align="center"> Concert du Jeudi 17 janvier 2002, 20H30</H1> 

<H4 align="center">Chapelle des Ursules</H4> 

<H3 align="center"X/H3> 

<H2 al ign="center"> Ensemble "A deux violes esgales" </H2> 

M. Mara is 

D. Castello 

F. Rognoni 

<P>Tarifs : <br>15,00 Euros <br>9,00 Euros ( jeunes) ,<br>10, 50 Euros (groupes). 
</P> 
</body> 
</html> 
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Extensions 

Les extensions sontdes ajoutsalaW3C Recommendation XSLT 1.0, leseul standard actuel- 
lement existant (en fevrier 2002). Ces ajouts concernent la definition et I 'implementation 

• de nouvellesfonctionsXPath ou XSLT ; 

• ou denouvel les instructions XSLT ; 

• ou denouveaux attributs pour des instructions XSLT existantes. 

Historiquement, ces extensions ont ete d'abord proposees et implementees par les 
concepteurs de processeurs XSLT, puis une initiative de « standardisation » est ensuite 
apparue pour tenter d'harmoniser les extensions les plus communes, et meme pour pro- 
poser aux fournisseurs de processeurs des extensions original es. Cette initiative a pris le 
nom d'EXSLT, et ses travaux sont disponibles sur le site www.exslt.org. Citons aussi la 
XSLTSL (XSLT Standard Library, xsltsl.sourceforge.net) qui est une une bibliotheque de 
modeles nommes « 100% pur XSLT » : ce ne sont done pas a proprement parler des 
extensions, mais certains de ces modeles nommes peuvent parfois recouper certaines 
fonctions proposees par EXSLT. 

Les extensions sont general ement des reponses a la pression des utilisateurs et de la 
concurrence entre fournisseurs de processeurs. Certaines comblent des lacunes du stan- 
dard W 3C X SLT 1.0, d'autres ne comblent aucune lacune proprement dite mais ouvrent 
des perspectives nouvellesdetraitement, et d'autres enfin sont des extensions de contort, 
qui simplifient beaucoup la programmation, ou qui ameliorent les performances par 
rapport a une solution « 100% pur XSLT ». 

Dans la categorie des extensions comblant des lacunes, on peut citer en tout premier lieu 
la fonction deconversion d'un RTF en node-set. On peut di re qu' une tel le foncti on estde 
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loin la plus necessaire de toutes les extensions ; mais comme nous en avons deja beau- 
coup parle (voir Temporary SourceTree, page 192 etOpe'rations sur un RTF (XSLT 1.0), 
page 209), il nesera pas utile d'y revenir ici dans le detail. 

Une autre lacunetresgenantedeXSLT 1.0 est I 'i impossibility d'ecrire une feuille de style 
qui produise en resultat plusieurs documents. C'est pourtant un besoin evident, notam- 
menten HTM L, si I'on veut par exempleproduireun resultat decoupe en plusieurs pages 
differentes, neserait-ce que pour genererdes<frame> etdes <frameset>, ou un ensemble 
de pages qui se referencent mutuellement (voir par exemple le pattern Pattern n°20 - 
Generation de documents multiples, page 563). 

Enfin une derniere lacune est la faiblesse des possibilites de traitement de dates. XSTL 
2.0 devrait retablir la situation, mais en attendant, on trouvera dans la XSLT Standard 
L i brary (http://xsltsl.sourceforge.net) beaucoup de choses i nteressantes dans le domai ne du 
traitement des dates, meime s'il est impossible de couvrir tous les besoins uniquement 
avec une bibliotheque de modeles nommes : le type date n'existant pas en tant que tel 
dans XSLT 1.0, il est par exemple impossible defaireun tri chronologique sur des dates 
avec I 'instruction <xsi :sort>. 

Dans la categorie des extensions ouvrant des perspectives de traitement, citons tout 
d'abord la fonction (reclamee par beaucoup d'utilisateurs) devaluation dynamique 
d'une expression XPath donnee sous forme d'une String. Un contexte souvent invoque 
pour justifier son utilisation est celui de la realisation de mises en pages pilotees par 
un document XML auxiliaire, specifiant disposition et contenu dans un format convenu, 
et comportant entre autres des expressions XPath a interpreter dynamiquement 
(voirPattern n°19 - Construction dynamique de I'agencement d'un tableau HTML, 
page 540). 

Une autre extension, un peu dans le mermeordred'idee, est un attribut nouveau pour I'ins- 
truction <xsi :cai l -tempi ate> (voir aussi Pattern n°19 - Construction dynamique de 

I 'agencement d'un tableau HTML, page 540), qui indique que I 'attribut name est fourni 
sous la forme d'un descripteur de valeur differee d' attribut (chose normal ement interdite) : 
lenom du modele a appeler est ainsi calcule a ['execution, cequi eviteeventuellementun 
<xsi :choose> avec de nombreux cas possibles (un cas par modele a appeler). 

I I faut ci ter aussi I es possi bi I ites de connexi on a une base de donnees rel ati onnel I e, au tra- 
vers d'instructions nouvelles, qui permettent done a une feuille de style de recevoir une 
requete, de la repercuter sur une base de donnees, d'obtenir une reponse, et de la ren- 
voyer decoree en HTM L (par exemple). 

Et pour finir, il y a I 'instruction (general ement nommee <xx:script>) qui permet d'imple- 
menter ses propres extensions en J ava, J avascript, etc., ce qui permet en particulier d'instal- 
ler sur un processeur (qui fournit cette extension xx:script) une extension propre a un 
autre processeur, pourvu qu'on ait les sources J ava ou J avascript de I 'extension. 

Enfin, dans la categorie des extensions de contort, on trouve beaucoup de choses diffe- 
rentes. Par exemple des instructions permettantde retrouver la programmation habituelle 
avec les bonnes vieilles affections ou la boucle while. On trouve aussi des fonctions 
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redondantes avec les possibilit.es natives de XSLT 1.0, maisqui apportentun gain de per- 
formance ou de simplicity appreciable (par exemple une fonction qui renvoie I 'intersec- 
tion de deux node-sets, ou bien une instruction qui permet de faire des regroupements 
sans avoir a les programmer dans le detail). 

Toutes ces extensions sont bien sflr dependantes du processeur utilise : certaines exten- 
sions ne sont pas supportees par certains processeurs, et lorsqu'une meme extension est 
supportee par plusieurs processeurs, les denominations sont generalement differentes 
(nodeseto, node-seto, nodeSeto, etc.), et les domaines nominaux a declarer pour 
prefixer ces extensions sont a coup sflr differents. Sauf si ... 

... Sauf si c'est une extension disponible sur EXSLT, et que le processeur utilise la four- 
nit. Auquel cas, la denomination et le domaine nominal sont definis par EXSLT, et non 
par lefournisseur du processeur, cequi garantit la portabi lite. A utrement, si I'on veut une 
feui I lede style uti I isant des extensions et compatible avec un ensemble de processeurs, il 
n'y a guere d'autre sol ution que de mai nteni r differentes versions de cette feui I le de style, 
cequi n'est pas une situation tres enviable, il fautbien I'avouer. 

Pour une liste precise et a jour des extensions disponibles avec chaque processeur, il 
fautse reporter a sa documentation ; par exemple : http://saxon.sourceforge.net/ ou http:// 
xml.apache.org/xalan-j/. 

Evolutions : XSLT 2.0 etXPath 2.0 

Si les extensions sont le fait des concepteurs de processeurs XSLT, les evolutions, el les, 
sont dues aux travaux du XSL Working Group du W3C, dont le but est de les proposer, 
puis de les stabiliser sous la forme d'une Final Recommendation. 

La seulerecommandation finale pour XSLT, a la date d'ecriture de ce livre (fevrier 2002), 
est eel I e du 16 novembre 1999 : c'est le standard XSLT 1.0. Bien sflr, des le debut des 
extensions ont commence a apparaitre, certaines fort pertinentes, et un groupe de travail 
s'est constitue pour prendre en compte le mieux possible certaines de ces extensions, et 
faire evoluer XSLT en 1.1. M ais les changements apportes ou proposes par la derniere 
version du Working Draft XSLT 1.1 (24 aoflt 2001) etaient trop importants pour que cette 
evolution puisse passer pour mineure. A ussi cette version a-t-elleete abandonneeen tant que 
telle, et les propositions qu'elleavancait ontete incorporees au chantier de la version 2.0 du 
langage. Deux Working Drafts (XSLT 2.0 etX Path 2.0) sont parusle20decembre2001, 
qui ouvrentde nouvel les perspectives sur ces langages. Bien sflr, rien n'est encore joue, 
et des evolutions importantes dans un sens ou dans I 'autre peuvent etre encore possibles 
d'ici la parution d'une Final Recommendation. On peut tout de meme tenter une breve 
sy nthese de ces evol uti ons. 

Perspectives pour XSLT 2.0 

Une premiere evolution, qu'on peut penser relativement peu sujette a etre remise en 
cause, concerne la redaction de la specification du langage. La version XSLT 1.0 eta it un 
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peu spartiate par bien des cotes, et beaucoup trap concise sur certains points, ce qui ren- 
dait la lecture assez ardue. D 'autre part, certains termes, comme template, etaient trap 
charges de sens differents suivant les contextes. U n effort a done ete fait, pour repenser la 
redaction, la completer, la rendre plus facile a lire et a comprendre, et pour proposer de 
nouveaux termes (par exemple content constructor, et non plus template) pour designer 
un model e de transformation. A noter que dans ce livre, cet effort a ete anticipe, puisque 
nous avions choisi ce terme de module de transformation bien avant que ne paraisse le 
WD XSLT 2.0. 

Les autres evolutions concernent le langage proprement dit; certaines sont mineures, 
d'autres sont majeures. Nous listerons certaines des evolutions majeures, pour donner 
une idee de la direction que va prendre XSLT. 

M al fames, les RTF (Result Tree Fragment, voir Temporary Source Tree, page 192) ont 
ete repudies, etcommeXSLT 1.1 leproposait, un Temporary Source Tree accroche a une 
variable est vu comme un objet de type node-set. Done tout ce qui a ete explique dans la 
section referenced ci-dessus est maintenu. 

Les programmes XSLT pourront creer plusieurs documents resultats, avec la nouvelle 
instruction <xsi :resuit-document>, qui fonctionne d'une facon largementinspireedece 
que propOSait <xsl :document> deXSLT 1.1. 

Une instruction <xsi :for-each-group>, al I ant de pair avec une nouvelle fonction cur- 
rent-group( ), a ete introduite pour faciliter les regroupements (voir Pattern n°14 - 
Regroupements, page 474. 

II sera possible d'ecrire non plus des modeles nommes, mais de veritables fonctions, que 
I'on pourra appeler dans des expressions XPath sans etre oblige d'utiliser le tank 

<xsl :cal 1 -tempi ate>. Pour Cela, I eS instructions <xsl :fimction> et <xsl :resu"lt> Ont 
ete propoSees. 

On peut done resumer tout ceci est disant que globalement, il sera a I'avenir moins ardu 
de programmer en XSLT, notamment grace a I 'introduction de la notion de fonction, et 
decellederegroupement. 



Perspectives pour XPath 2.0 

En cequi concerne XPath, il s'agit plus d'une revolution qued'unesimpleevolution. 
En effet, un nouveau langage, X Query 1.0, a ete defini, et sa definition repose sur 
XPath 2.0. Ce qui veut dire que les groupes de travail XSL et XM L Query ont joint 
leurs forces pour defini r de facon commune le langage XPath 2.0. Autant dire que 
XPath prend une nouvelle orientation, afin de convenir a la fois aux besoins deXSLT 
etdeX Query. 

Pour comprendre cette evolution, il faut savoir que XQuery est un langage XM L de 
requetes sous forme d'expressions ; ces expressions obeissent a une grammaire qui est un 
sur-ensemblede XPath 2.0. D'une certaine maniere, on peut dire que les langagesXSLT 
et XQuery sont a la fois complementaires et redondants suivant la facon dont on les 
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analyse. Complementaires parce que le domaine d'XSLT est pi utot eel ui de la transfor- 
mation que celui delarequete; redondants parce que XSLT etXQuery fournissenttous 
les deux le moyen d'exprimer des recherches dans un document XML arbitral rement 
complexe, maisanouveau complementaires, meme dans ce domaine, parce que X Query 
est clai rement plus simple a utiliser que XSLT pour exprimer des requetes complexes, et 
surtout est concu pour favoriser une optimisation tres poussee de ces requetes, de la 
meme facon que SQL a ete a I'origine d'optimisations tres fines des moteurs de bases de 
donnees relationnelles. 

Les evolutions d'XPath portent d'abord sur le modele de donnees utilise : desormais, 
XPath repose sur les types simples definis par les Schemas XML (www.w3.org/TR/ 
xmlschema-2) ; d'autre part, XPath offre maintenant la notion de Sequence, qui est une 
liste ordonnee de valeurs, et qui vient done en complement de la notion d'arbre, qui eta it 
jusqu'a present la seule structure de donnees utilisable. 

XPath 2.0 introduitde plus des extensions aux constructions existantes, etdesoperateurs 
nouveaux. Par exemple, la notion d'etape de localisation a ete etendue a eel le d'etape 
general i see, qui peut faire intervenir une expression XPath, ce qui permet d'ecrire des 
choses comme : 

partie/tchapitre | annexe) /pa rag raphe 

ou comme 

documents "truc.xml " )/key ( "...") 

Des expressions nouvelles apparaissent, notamment I 'expression for/return (qui 
retourne une sequence de valeurs), I 'expression if (qui retourne une valeur parmi deux 
possibles, suivant une condition), et I'assertion booleenne quantified some/every/ 

sati f i es. 

Exemples : 

Expression for/return 

for $a in distinct-values(//author) 
return ( 

$a, 

for $b in //book[$b/author = $a] return $b/title 

) 

Expression if 

if (@pseudonyme) 
then ©pseudonyme 
else @nom 

Assertion quantifiee 

I some $emp in //employee satisfies 
($emp/bonus > 0.25 * $emp/sal ary ) 
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Enfin de nouveaux operateurs sont proposes, == pour tester I 'identite de deux nceuds, et « 
pour tester I'ordred'apparition dedeux nceuds au sein d'un meme document. Exemples : 

Exemples : 

Test d' identite 

//book[@isbn = '12345'] == //author[@name='dudule']/book[l] 

Test d'anteriorite (ordre de lecture du document) 

//book[@isbn = '12345'] « //book[@isbn = '54321'] 

On voit done que X Path change completement de statut : avant e'etait un humble servi- 
teur deXSLT, desormais il est le socle sur lequel sera bati le langage X Query (et dans 
une moindre mesureXSLT). Et comme il est probable qu'a I'avenir il ne sera plus suffi- 
sant de connaitre uni quement X SLT, car certai nes appl i cati ons devront uti I i ser conjointe- 
mentXSLT etXQuery pouretrevraiment performantes, on peut penser que I 'importance 
de X Path ne fera que croftre. 
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Notations 

Les mots en italique sont des symboles terminaux (c'est-a-dire non definis dans les 
regies syntaxiques). 

Les accolades { } font parti e de la syntaxe decrivant certains attributs. El les denotent la 
possibility d'utiliser desAVT (Attribute Value Template), ou descripteur de valeur diffe- 
red d'attri but. Laoii il n'y a pas d'accolades, c'est que I'emploi de descripteur de valeur 
differee d'attri but est interdit. 

Certaines notations propres aux DTD sont reprises ici : 

• x* signifie que x peut apparaitre 0, 1 ou plusieurs fois ; 

• x? signifie que x peut apparaitre 0 ou 1 fois ; 

• x+ signifie que x peut apparaitre 1 ou plusieurs fois ; 

• x | y signifie que x peut apparaitre ou que y peut apparaitre; 

• "x- signifie que x doit apparaitre litteralement. 

Symboles terminaux 

qname 

L e symbol e qna me veut dire Quailed Name. Un nom qualifie estun nom XM L avec ou 
sans prefixe, comme par exemple true ou fo:biock. 

ncname 

Lesymbole ncname veut dire Non Colonized Name. C'est un nom XML sans prefixe. 
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qname-but-not-ncname 

Lesymboleqname-but-not-ncname estun nom XM L obligatoirement prefixe. 
prefix 

U n pre/ix est un ncname qui sert de prefixe dans un qname. 
uri-reference 

Le symbole uri-reference veut dire Unique Resource Identifier. C'est une generalisation 
del a notion d'URL, qui pour I 'instant n'est pas encore vraimentstabi I i see. On peut done 
considererqueURI etURL sont synonymes. 

pattern 

Le symbole pattern veut dire ici motif, 
expression 

U ne expression veut dire une expression X Path quelconque. 
node-set-expression 

Une node-set-expression est une expression X Path qui renvoieun node-set. 
boolean-expression 

Une boolean-expression est une expression X Path qui renvoie une valeur booleenne. 
number-expression 

U ne number-expression est une expression X Path qui renvoie nombre. 
string-expression 

Une string-expression est une expression X Path qui renvoie une String, 
nm token 

Un nmtoken (NameToken) est une suite de caracteres val ides pour former un nom XM L. 
nametest-tokens 

U n nametest-tokens est une suite de nametest separes par des espaces blancs. U n name- 
test est un determinant, intervenant dans une etape de local isationX Path. Un nametest 
peutetre un qname, ou une etoile, ou une etoi le prefixee (par exemple "fo:*"). 

ncname-tokens 

U n ncname-tokens est une suite de ncname separes par des espaces blancs. 
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Regies syntaxiques 

Instruction xsl :apply-imports 

<xsl :apply-imports /> 

Instruction xsl :apply-templates 

<xsl :apply-templates 

select = node-set-expression 
mode = qname> 

<!-- Contenu : (xsl:sort | xsl :with-param)* --> 
</xsl :apply-templates> 

Instruction xsl :attribute 

<xsl :attribute 

name = { qname } 

namespace = { uri -reference )> 

<!-- Contenu : modele de transformation --> 

</xsl :attribute> 

Instruction de premier niveau xsl :attribute-set 

<xsl :attribute-set 
name = qname 

use-attribute-sets = qnames> 
<!-- Contenu : xsl :attribute*--> 
</xsl :attribute-set> 

Instruction xsl : call -tempi ate 

<xsl :call-template 
name = qname> 

<!-- Contenu : xsl :with-param*--> 
</xsl :call-template> 

Instruction xsl:choose 

<xsl :choose> 

<!-- Contenu : (xsl :when+, xsl :otherwise?) --> 
</xsl :choose> 

Instruction xsl :comment 

<xsl :comment> 

<!-- Contenu : modele de transformation --> 

</xsl :comment> 

Instruction xsl:copy 

<xsl :copy 

use-attribute-sets = qnames> 

<!-- Contenu : modele de transformation --> 

</xsl :copy> 
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Instruction xsl:copy-of 

|<xsl :copy-of 
select = expression /> 

Instruction de premier niveau xsl : decimal -format 

<xsl :decimal -format 
name = qname 

decimal -separator = char 
grouping-separator = char 
infinity = string 
minus-sign = char 
NaN = string 
percent = char 
per-mille = char 
zero-digit = char 
digit = char 

pattern-separator = char /> 

Instruction xsltelement 

<xsl :element 

name = { qname } 

namespace = { uri -reference } 

use-attribute-sets = qnames> 

<!-- Contenu : modele de transformation --> 
</xsl :el ement> 

Instruction xs1:fal1back 

|<xsl :fallback> 
<!-- Contenu : modele de transformation --> 
</xsl :fallback> 

Instruction xsl :for-each 

<xsl :for-each 

select = node-set-expression> 

<!-- Contenu : (xsl:sort*. modele de transformation) --> 

</xsl :for-each> 

Instruction xsl :if 

<xsl :if 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 

</xsl :if> 

Instruction de premier niveau xs1:import 

|<xsl : import 
href = uri -reference /> 
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Instruction de premier niveau xsl: include 

|<xsl : include 
href = uri -reference /> 

Instruction de premier niveau xsl: key 

<xsl : key 

name = qname 
match = pattern 
use = expression /> 

Instruction xsl :message 

<xsl :message 

terminate = "yes" | "no"> 

<!-- Contenu : modele de transformation --> 

</xsl :message> 

Instruction de premier niveau xsl :namespace-alias 

<xsl :namespace-alias 

stylesheet-prefix = prefix | "#default" 
result-prefix = prefix | "#default" /> 

Instruction xsl:number 

<xsl : number 

level = "single" | "multiple" | "any" 

count = pattern 

from = pattern 

value = number-expression 

format = { string } 

lang = { nmtoken ) 

letter-value = { "alphabetic" | "traditional" } 
grouping-separator = { char } 
grouping-size = { number } /> 

Partie d'instruction xsl otherwise 

<xsl :otherwise> 

<!-- Contenu : modele de transformation --> 

</xsl :otherwise> 

Instruction de premier niveau xsl:output 

<xsl :Output 

method = "xml" | "html" | "text" | qname-but-not-ncname 
version = nmtoken 
encoding = string 

omit-xml-declaration = "yes" | "no" 
standalone = "yes" | "no" 
doctype-publ ic = string 
doctype-system = string 
cdata-section-elements = qnames 
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I indent = "yes" | "no" 
media-type = string /> 

Instruction de premier niveau ou partie d'i instruction xsl:param 

<xsl :param 

name = qname 

select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :param> 

Instruction de premier niveau xsl :preserve-space 

|<xsl :preserve-space 
elements = nametest-tokens /> 

Instruction xsl :processing-instruction 

<xsl :processing-instruction 
name = { ncname }> 

<!-- Contenu : modele de transformation --> 

</xsl :processing-instruction> 

Partie d'instruction xsl:sort 

<xsl :sort 

select = string-expression 
lang = { nmtoken } 

data-type = { "text" | "number" | qname-but-not-ncname} 
order = { "ascending" | "descending" } 
case-order = { "upper-first" | "lower-first" } /> 

Instruction de premier niveau xsl :strip-space 

|<xsl :strip-space 
elements = nametest-tokens /> 

Racine du document XSLT xsl : stylesheet 

<xsl :stylesheet 
id = id 

extension-element-prefixes = ncname-tokens 
excl ude-result-prefixes = ncname-tokens 
version = number> 

<!-- Contenu : (xsl : import*, Instructions de premier niveau) --> 

</xsl :stylesheet> 

Instruction de premier niveau xsl: tempi ate 

<xsl :templ ate 

match = pattern 
name = qname 
priority = number 
mode = qname> 

<!-- Contenu : (xsl : pa ram*, modele de transformation) --> 
</xsl :templ ate> 
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Instruction xsl:text 

<xsl :text 

disable-output-escaping = "yes" | "no"> 
<!-- Contenu : #PCDATA --> 
</xsl :text> 



Racine du document XSLT xsl : transform 

<xsl :transform 
id = id 

extension-element-prefixes = ncname-tokens 
excl ude-result-prefixes = ncname-tokens 
version = number> 

<!-- Contenu : (xsl : import*, top-level-elements) --> 

</xsl :transform> 

Instruction xsl:value-of 

<xsl :val ue-of 

select = string-expression 
disable-output-escaping = "yes" | "no" /> 

Instruction de premier niveau ou instruction xsl:variable 

<xsl :variable 
name = qname 
select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :variable> 

Partie d'instruction xsl : when 

<xsl :when 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 

</xsl :when> 

Partie d'instruction xsl :with-param 

<xsl :with-param 
name = qname 
select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :with-param> 



E 



Reference des fonctions 

predefinies 



Fonctions XPath 



Note 

Cette annexe estune adaptation de la traduction frangaise de la Recommandation XPath 1.0 du 16 novembre 
1999, realisee parj ean-J acquesThomasson etYves Bazin. E Me est disponible a I'adresse http://xmlfr.org/w3c/ 
TR/xpath. Les modifications consistent essentiellement en une homogeneisation de vocabulaire, de locutions et 
de tournures avec le reste du livre. Quelques remarques en marge du texte ontete ajoutees ga et la, pour eclai- 
rerla comprehension. 

Cette section decrit les fonctions que les implementations de XPath doivent toujours 
incluredans leurs bibl iotheques de fonctions utilisees pour I 'interpretation des expressions. 

Chaque fonction de la bibliotheque est specifiee en utilisant une fonction prototype, qui 
donneletype retourne, le nom de la fonction et le type des arguments. Si un typed'argu- 
ment est suivi d'un point d'interrogation, cela signifle que cet argument est optionnel ; 
sinon, I 'argument estrequis. 

Fonctions de manipulation de node-sets 
number last() 

La fonction last retourne un nombre egal au nombre total de nceuds memorise dans le 
contexte devaluation del 'expression (voir Contexted 'evaluation d'un predicat, page 57). 
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number position() 

La fonction position retourne un nombre egal a I'indice de proximite memorise dans le 
contexte devaluation del 'expression (voir Contexte d 'evaluation d'un predicat, page 57). 

number count( node-set ) 

La fonction count retourne le nombre de nceuds du node-set passe en argument. 
node-set id( object ) 

La fonction id selectionne les elements par leur identi riant unique. Quand I'argument 
de la fonction id est du type « node-set », alors le resultat est I 'ensemble des resultats de 
I 'application de la fonction id a la valeur textuel I e (string-value) dechacun des nceuds du 
node-set passe en argument. Quand I'argument de la fonction id est d'un autre type, 
celui-la est converti en une chaine de caracteres comme par un appel a la fonction string. 
La chaine de caracteres est transformee en une serie d'unites lexicales separees par des 
espaces blancs. Le resultat est un node-set contenant les elements du meme document 
que le nceud contexte et qui ont un identi riant unique egal a I'une quelconque des unites 
lexicales de la serie. 

• idctruc") selectionne I 'element qui a comme identi fiant unique true ; 

• id("truc")/child: :para[position( )=5] Selectionne le Cinquieme enfant para de 

I 'element qui a comme identifiant unique true. 
string local-name( node-set ? ) 

La fonction local-name retourne la parti e locale du nom du nceud du node-set passe en 
argument qui est le premier dans I'ordre de lecture du document. Si le node-set passe 
en argument est vide ou que le premier nceud n'a pas de nom, la fonction retourne une 
chaine de caracteres vide. Si I'argument est omis, la valeur par defaut utilisee par la fonction 
est un node-set reduit au seul nceud contexte. 

string namespace-uri( node-set ? ) 

La fonction namespace-uri retourne I'URI correspondant au domaine nominal du nceud 
du node-set passe en argument qui est le premier dans I'ordre de lecture du document. Si 
le node-set passe en argument est vide, ou si le premier nceud n'a pas de nom, ou n'a pas 
de domaine nominal, une chaine vide est retournee. Si I'argument est omis, e'est comme 
si on avait transmis un node-set ne contenant que le nceud contexte. 

Note 

La chaine retournee par la fonction namespace-uri est vide sauf pour les nceuds de type element et attribute. 
string name( node-set ? ) 

La fonction name retourne une chaine contenant un nom qualifie representantlenom du 
nceud du node- set passe en argument qui est le premier dans I 'ordre de lecture du document. 
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Ce nom qualifie tient compte de la declaration du domaine nominal en vigueur sur le 
nceud en question. 

General ement, le nom retourne est le meme que le nom qualifie apparaissant dans le source 
XM L. Maisil peuty a voirdescasou lenom retourne n'emploie pas le meme prefixe que 
dans le source XM L ; meme dans ce cas, il reste encore certain que le domaine nominal 
associe a ce prefixe est le meme que celui declare pour le nceud considers dans le source 
XM L. Si le source XM L utilise pi usieurs prefixes pour le meme domaine nominal, lafonc- 
tion nameo peuttres bien normal iser la situation en n'en n'utilisantqu'un seul. 

Si le node-set passe en argument est vide ou que le premier noeud n'a pas de nom, une 
chaine vide est retournee. Si I 'argument est omis, c'est comme si on avait transmis un 
node- set ne contenant que le nceud contexte. 

Note 

La chaine retournee parla fonction name estidentique acelle retournee parla fonction l ocal -name, excepte pour 
les noeuds de type el ement et attri bute. 

Fonctions manipulant des chafnes de caracteres 
string string( object ? ) 

La fonction string convertit un objet en chaine de caracteres selon les regies indiquees 
ci-dessous. 

U n node-set est converti en chaine de caracteres en retournant la valeur textuelle du pre- 
mier nceud du node-set dans I 'ordre de lecture du document. Si I e node-set est vide, une 
chaine vide est retournee. 

U n nombre est converti en chaine comme suit : 

• N aN est converti en la chaine de caracteres NaN ; 

• I e zero positif est converti en la chaine o (caractere zero) ; 

• I e zero negatif est converti en la chaine o (caractere zero) ; 

• I'infini positif est converti en la chaine infinity ; 

• I'infini negatif est converti en la chaine -infinity ; 

• si le nombre est un entier, il est represents sous forme decimale comme un nombre 
(Number) sans point decimal et sans chiffre apres la virgule, preceded'un signemoins 
(-) si le nombre est negatif ; 

• sinon, le nombre est represents sous la forme d'un Nombre (Number) ayant toujours 
au moins un chiffre avant et apres le point decimal, precede du signe moins (-) si le 
nombre est negatif ; si le nombre est inferieur a 1 en valeur absolue, il n'y a qu'un seul 
0 avant le point decimal. Enfin, au dela du premier chiffre requis apres le point deci- 
mal, il doit y avoir le nombre de chiffres necessaire et suffisant pour differencier sans 
ambiguite I e nombre de toutes les autres valeurs numeriques du standard IEEE 754. 
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La valeur booleenne fai se est convertie en la chaine de caracteres fai se. La valeur boo- 
leenne true est convertie en la chaine de caracteres true. 

Tout objet d'un type different des quatre types de base est converti en chaine de caracte- 
res selon une regie propre au type en question. 

Si I'argument est omis, c'est comme si on avait transmis un node-set ne contenant que le 
nceud contexte. 

Note 

La fonction string( ) n'est pas faite pour formater des nombres en chaines de caracteres pour les besoins 
d'affichage ou de presentation aux utilisateurs. La fonction format-number et I'element xsi : number de XSLT 
sontla pourga. 

string concat( string , string , string *) 

La fonction concat retourne le resultat de la concatenation des arguments. 
boolean starts-with( string , string ) 

L a fonction starts-with retourne la valeur booleenne true si la premiere chaine de carac- 
teres passee en argument commence par la chaine de caracteres passee en deuxieme 
argument; sinon, cette fonction retourne la valeur false . 

boolean contains! string , string ) 

La fonction contains retourne true si la premiere chaine de caracteres passee en argu- 
ment contient la chaine de caracteres passee en deuxieme argument ; sinon, retourne la 
valeur false . 

string substring-before( string , string ) 

La fonction substring-before(sl,s2) retourne la sous-chaine de si qui precede la pre- 
miere occurrence des2 dans si, ou une chaine vide si si ne contient pas s2. Parexemple, 

substring-before( "1999/04/01" , "/" ) retoume 1999. 

string substring-after( string , string ) 

La fonction substring-after(sl,s2) retourne la sous-chaine de si qui suit la premiere 
occurrence de s2 dans si, ou une chaine vide si le si ne contient pas s2. Par exemple, 

substring-after("1999/04/01","/") retOUme 04/01, et substri ng-af ter( "1999/04/ 

oi", "19") retourne 99/04/01. 

string substring! string , number , number ? ) 

La fonction substring(str, indexDebut, Ig) retourne la sous-chaine de str commencant 

a la position indexDebut et de longueur lg. Par exemple, substring("12345",2,3) 

retourne "234". Si le troisieme argument n'est pas specifie, la fonction retourne la sous- 
chaine al I ant de la position de depart specifiee par indexDebut jusqu'a la fin de str. Par 

exemple, substring("12345",2) retOUme "2345". 
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Plus precisement, chaque caractere de la chainea une position numerique : celledu pre- 
mier caractere est 1, celledu deuxieme est 2, etc. 

Note 

Ceci differe de J ava et ECMAScript, dans lesquels les methodes string. substring considered que la position 
du premier caractere estO. 

L a sous-chaine retournee contient les caracteres dont la position est superieure ou egale a 
la valeur arrondie de indexDebut et (si le troisieme argument ig est specifie) inferieure 
a la somme des valeurs arrondies de indexDebut et ig ; les comparaisons et I'addition 
uti I i sees ci-dessus doivent suivre les regies du standard IEEE 754 ; I'arrondi est calcule 
comme par un appel a la fonction round. 

Les exemples suivants i 1 1 ustrent differents cas de figures courants : 

• substring("12345" , 1.5, 2.6) retOUrne "234" ; 

• substring("12345" , 0, 3) retOUme "12" ; 

• substring( "12345", 0 div 0, 3)retOUme"" ; 

• substring("i2345" , i, o div 0) retourne"" ; 

• substring( "12345", -42, 1 div 0) retOUme "12345" ; 

• substring("12345" , -1 div 0, 1 div 0) retOUme " ". 

number string-length( string ? ) 

La fonction string-length retourne le nombre de caracteres de la chaine. Si I'argument 
est omis, la valeur retournee est egale a la longueur de la valeur textuelle du nceud 
contexte. 

string normalize-space( string?) 

La fonction normalize-space retourne la chaine de caracteres passee en argument apres 
y avoir normalise les espaces blancs : suppression des espaces blancs en debut et fin et 
remplacement des sequences d'espaces blancs successifs par un seul caractere blanc. 
Si I'argument est omis, la fonction retourne la chalne obtenue en ayant utilise comme 
argument la valeur textuelle du nceud contexte. 

string translate( string , string , string ) 

L a fonction translate retourne la premiere chaine de caracteres passee en argument dans 
laquelle les occurrences des caracteres de la deuxieme chaine sont remplacees par les 
caracteres correspondant aux memes positions de la troisieme chaine. Par exemple, 
translated. "bar", "abc", -ABC") retourne la chaine BAr . Si I'un des caracteres du 
deuxieme argument n'a pas de position correspondante dans le troisieme (parce que 
le deuxieme argument est plus long que le troisieme), alors les occurrences de ce carac- 
tere sont supprimees du premier argument. Par exemple, transiate("--aaa--" , "abc-" . 
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"Abc") retourne "AAA". Si un caractere apparait plus d'unefois dans la deuxieme chaine, 
alors c'est la premiere occurrence de ce caractere qui determine la regie de transforma- 
tion. Si la chaine passee en troisieme argument est plus longue que la deuxieme, alors, les 
caracteres en trop sont ignores. 

Note 

La fonction translate n'est pas suffisante pour les changements de casse dans toutes les langues. line future 
version de XPath fournira des fonctions additionnelles a cette fin. 



Fonctions Booleennes 

boolean boolean( object ) 

La fonction boolean convertit ses arguments en booleens selon les regies suivantes : 

• un nombre est vrai (true) si et seulement s'il n'est ni unzero positif ou negatif, ni un 
NaN ; 

• un node-set est vrai (true) si et seulement s'il n'est pas vide; 

• une chaine de caracteres est vraie (true) si etseulementsi sa longueur n'est pas nulle; 

Un objet d'un type autre que les quatre types de base est converti selon des regies speci- 
fiques a chaque type. 

boolean not( boolean ) 

La fonction not retourne la negation logiquede la valeur du booleen passe en argument : 
vrai (true) si I 'argument est faux et vice-versa. 

boolean true() 

La fonction true() retourne true. 
boolean false() 

La fonction false() retourne false. 
boolean lang( string ) 

La fonction lang retourne true si et seulement si la langue associee au nceud contexte 
correspond a la langue passee en argument de la fonction, ou en est une variante locale. 

La langue du nceud contexte est determined par la valeur de I'attribut xmi :iang du nceud 
contexte, ou, si celui-ci n'a pas cet attri but, par la valeur de I'attribut xml : 1 ang du plus 
proche ancetre du nceud contexte ayant cet attri but. Si aucun n'est trouve, la fonction 
lang retourne la valeur false. Si un tel attri but existe, alors la fonction lang retourne la 
valeur true si la valeur de I'attribut estegale a eel I e passee en argument (les differences 
de casse etantignorees), ou s'il existeun certain suffixecommencant par - desorteque la 
valeur de I 'attri but soit egale a I 'argument si on ignore ce suffixe et la casse. Par exemple, 
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1 ang( "en ") retourne la valeur true si le nceud contexte est I'un des quatre elements 
<para> suivants : 

• <para xml : 1 ang="en"/> ; 

• <div xml : 1 ang="en"Xpara/X/di v> ; 

• <para xml : 1 ang="EN"/> ; 

• <para xml :1 ang="en-us"/>. 

Fonctions numeriques 

number number( object ? ) 

La fonction number convertit en nombre son argument passe selon les regies indiquees 
ci-dessous. 

• Une chaine de caracteres qui est composee d'espaces blancs (optionnels) suivis du 
signemoins (-) suivi d'un nombre (Number) suivi d'espaces blancs estconvertieen un 
nombre le plus proche possible (selon la regie d'arrondi au plus proche de I'lEEE 754) 
du nombre IEEE 754 le plus proche possible de la valeur mathematique exacte repre- 
sentee par la chaine ; toute autre chaine est convertie en NaN . 

• Les booleens vrais ( true ) sont convertis en 1 ; les booleens faux ( false ) sont 
convertis en 0. 

• U n node-set est d'abord converti en chaine de caracteres comme par I'effet d'un appel 
a la fonction string et cette chaine est ensuite considered comme argument de la fonc- 
tion number. 

• Un objetde type different des quatre types debase est converti en un nombre selon des 
regies dependantes du type de I 'objet. 

Si I'argument est omis, la valeur retournee par defaut est eel le qui auraitete obtenue en 
considerant un node-set contenant le seul nceud contexte. 

Note 

La fonction number ne doit pas etre utilisee pour convertir des donnees numeriques se trouvant dans un 
elementd'un documentXML sauf si Pelementen question estd'un type permettantde representor des donnees 
numeriques dans un format neutre (qui serait typiquement transforme dans un format specifique pour etre 
presentees a un utilisateur). De plus, la fonction number ne peut etre utilisee que si le format neutre utilise par 
Pelement est coherent avec la syntaxe XPath definie pourles nombres (Number). 

number sum( node-set ) 

La fonction sum retourne la somme, pourtous les nceudsdu node-set passe en argument, 
des resultats de la conversion en nombre des valeurs textuel les (string-values) dechacun 
deces nceuds. 
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number floor( number) 

La fonction floor retourne le plus grand (du cote de I'infini positif) nombre entier infe- 
rieur a I'argument. 

number ceiling( number ) 

La fonction ceiling retourne leplus petit (du cote de I'infini negatif) nombre entier qui ne 
soit pas inferieur a I'argument. 

number round( number ) 

La fonction arrondi ( round ) retourne I e nombre entier leplus proche del 'argument. S'il 
y a deux nombres possibles, alors celui des deux qui est le plus proche de I'infini positif 
est retourne. Si I'argument est NaN, alors NaN est retourne. Si I'argument est I'infini 
positif, alors I'infini positif est retourne. Si I'argument est I'infini negatif, alors I'infini 
negatif est retourne. Si I'argument est I e zero positif, alors lezero positif est retourne. Si 
I'argument est le zero negatif, alors le zero negatif est retourne. Si I'argument est infe- 
rieur a zero, mais plus superieur ou egal a -0.5, alors lezero negatif est retourne. 

Note 

Pour les deux derniers cas, le resultatde I'appel de la fonction round ne donne pas le meme resultat qu'en addi- 
tionnant 0.5 au resultatde la fonction floor. 

Fonctions XSLT 

Fonctions de manipulation de node-sets 
node-set document^ object , node-set ? ) 

La fonction documentc ) permet d'acceder aux documents XML autres que le document 
source principal. 

Lorsque la fonction documento a exactement un argument et que cet argument est un 
node-set alors, le resultat est I 'union, pour chaque nceud du node-set recu en argument, 
du resultat de I 'execution de la fonction documento avec comme premier argument la 
valeur textuelle du nceud, et comme deuxieme argument un node-set dont I 'unique ele- 
ment est le nceud lui-meme. Lorsque la fonction documento a deux arguments et que le 
premier argument est un node-set, alors le resultat est la reunion, pour chaque nceud du 
node-set recu en argument, du resultat de I 'execution de la fonction documento avec 
comme premier argument la valeur textuelle du nceud et, comme deuxieme argument, le 
deuxieme argument passe a la fonction documento. 

Si le premier argument de la fonction document n'est pas un node-set alors il sera 
converti en une chaine de caracteres comme par appel a la fonction stringo. Cette 
chaine de caracteres est traitee comme une reference a un URI ; la ressource identified 
par I'U R I est extraite. Les donnees resultant de la fonction d'extraction sont analysees 
comme un document XML et un arbre est construit en concordance avec le modele de 
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donnees (voir Module arborescent d'un document XML vu par XPath, page 30). Si 
I'extraction de la ressource se solde par une erreur, alors le processeur XSLT peut signa- 
ler I'erreur ; s'il ne lefait pas, il doit retourner un node-set vide. Le genre d'erreur pou- 
vant se produire a I 'extraction, serait que le processeur X SLT ne connaisse pas la syntaxe 
uti I i see pour I'URI. Un processeur XSLT n'est pas cense connaitre toutes les syntaxes 
particulieres d'URI. Les syntaxes d'UR I acceptees par un processeur XSLT doiventetre 
clairement indiquees dans sa documentation. 

En marge de ce texte 

Un identificateur de fragment est un identificateur qui designe une partie d'une ressource. Par ex., pour I'URL 
http://www.truc.Org/index.html#ici, I'identificateurde fragmentest ici, 

Si la reference a I'URI ne contient pas d'identiricateur de fragment, alors la fonction 
retourne le node-set contenant uniquement le nceud racine du document. Si la reference a 
I'URI contient un identificateur de fragment, alors la fonction retourne un node-set 
contenant les nceuds de I' arbre identifies par I 'identificateur defragment de la reference a 
I'URI. La semantique de I 'identificateur de fragment depend du type de media (type 
MIME) du resultat de I'extraction de I'URI. Si lors du traitement de I 'identificateur de 
fragment, une erreur se produit, le processeur XSLT peut signaler cette erreur, ou bien 
retourner un ensemble vide de nceuds. Exemples d'erreurs possibles : 

• L'identificateur du fragment fait reference a quelque chose qui ne peut etre represents 
parun node-set XSLT (comme une sous-chaine de caracteres a I'interieur d'un nceud 
texte). 

• Le processeur XSLT ne connait pas la facon de traiter les identi ficateurs de fragment 
pour le type M IM E du resultat de la recuperation. Un processeur XSLT n'est pas sup- 
pose pouvoir traiter tous les types MIME parti culiers. La documentation de chaque 
processeur X SLT doit indiquer quels sont les types MIME acceptes pour le traitement 
des identi ficateurs de fragments. 

L es donnees resultant de I 'action d'extraction sont analysees comme tout autre document 
XML sanstenir comptedu typeM IM E du resultat del 'extraction ; si letype MIME prin- 
cipal est text, alors il est analyse comme si le type MIME etait text/xml ; autrement, il 
est analyse comme si le type MIME etait application/xml. 

Note 

Puisqu'il n'y a pas de type MIME principal xml, les donnees avec un type MIME autre que text/xml ou appii- 
cation/xmi peuventtres bien etre quand meme des donnees XML. 

La reference a I'URI peut etre relative. L'URI de base (voir Remarque ci-dessous) du 
nceud qui apparaitle premier dans le document et qui appartientau node-set du deuxieme 
argument est utilise comme U Rl de base pour resoudre les U Rl relatifs et les transformer 
enURI absolus. Lorsque le deuxieme argument est omis, il est par defaut egal al'element 
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XSLT (lenceud del'arbreX M L du programme XSLT) qui contientl'expression ou figure 
I'appel a la fonction document c ). Notez qu'une reference a un URI detaille nulle est une 
reference au document dont I'URI qui lui est relatif est en cours de resolution ; ainsi 
documentc • ■ ) fait reference au nceud racine de la feuille de style elle-meme; I'arbre 
XML delafeuilledestyleestexactementlememequecelui qu'on obtiendraiten prenant 
cette feuille de style comme document source initial. 

URI de base (remarque en marge de ce texte) 

A chaque nceud est associe un URI qu'on appelle son URI de base, qui est utilise pour resoudre des valeurs 
d'attributs qui represententdes URI relatifs (c'est-a-dire pour determiner I'URI absolu connaissant I'URI relatif), 
suivant un principe identique a celui de la construction d'un chemin absolu designant un fichier, connaissant un 
chemin relatif etun repertoire de base qui sertde reference pour revaluation du chemin relatif), Si un elementou 
une processing-instruction apparaitdans une entite externe, alors son URI de base estl'URI de I'entite externe ; 
autrement, I'URI de base estl'URI de base du document. L'URI de base du noeud racine de I'arbre XML estl'URI 
de I'entite document. L'URI de base d'un nceud text, d'un ncsud comment, d'un noeud attribute ou d'un nceud 
name-space estl'URI de base de son nceud parent 

Prenons parexemple I'instruction <xsi : include href ="..."/> d'une certaine feuille de style que I'on suppose 
ecrite d'un seul tenant (pas d'entite externe). L'URI de base de cette instruction est done I'URI de base de la 
feuille de style elle-meme, qui n'est autre que le repertoire qui la contient. Si done I'URI indique dans I'attribut 
href est un URI relatif, il sera alors resolu par rapport ace repertoire. 

Deux documents sont considered comme n'en faisant qu'un s'ils sont identifies par le 
meme URI. L'URI utilise pour la comparaison est I'URI absolu pour lequel chaque URI 
relatif a ete resolu et ne contient aucun identificateur de fragment. Les nceuds racine de 
deux documents identifies par le meme URI sont considers comme indiscernables. 
Ainsi, I'expression suivante est touj ours vraie : 

generate- id (document ( "truc.xml " ) )=generate- id (document ( "truc.xml " ) ) 

Avec la fonction documentc ), s'ouvre la possibility qu'un node-set puisse contenir des 
nceuds provenant de plusieurs documents differents. Dans un tel node-set, I'ordrede lec- 
ture du document applicable a deux nceuds provenant du meme document est I 'ordre nor- 
mal de lecture du document defini par X Path. L'ordrede lecture du document applicable 
a deux nceuds provenant de deux documents differents est determine par I 'implementa- 
tion. La seule contrainte est que implementation doit etre coherente avec elle-meme : 
un meme ensemble de documents doit toujours produire le meme ordre. 

node-set key( string , object ) 

La fonction key( ) joue le meme role pour les cles que celui de la fonction id( ) pour les 
I D s. L e premi er argument sped fie I e nom de I a cle. L a val eur de cet argument doit etre un 
QName (nom qualifie). Lorsque le type du deuxieme argument de la fonction key( ) est 
un node-set, alors le resultat est la reunion des resultats de I 'application de la fonction 
key( ) a la valeur de la chalne de caracteres de chacun des nceuds du node-set recu en 
deuxieme argument par la fonction. Si le type du deuxieme argument de la fonction 
keyo n'est pas le type node-set, alors I 'argument est converti en une chainede caracteres 
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commeparappel a la fonction stringo ; elleretourneun node-set contenant des noeuds 
du meme document que celui auquel appartient le nceud contexte. Ces noeuds sont ceux 
qui ont une valeur pour cette cle nommee, et pour lesquels cette valeur est egale a cette 
chaine de caracteres. 

Etantdonne, parexemple, la declaration suivante : 

<xsl:key name="idkey" match="div" use="@id"/> 

I'expression key("idkey-,@ref) retourne I e meme ensemble de noeuds que id(@ref), a 
condition que leseul attri but I D declare dans le document source XM L soit: 

<!ATTLIST div id ID #IMPLIED> 

et que I 'attri but ref du nceud courant necontienne pas d'espace blanc. 

Considerons un document decrivant une bibliotheque de fonctions et utilisant un element 
prototype pour definir les fonctions : 

<prototype name="key" return-type="node-set"Xbr> 
<arg type="string"/Xbr> 
<arg type="object"/Xbr> 
</prototype> 

ainsi qu'un element function pour faire reference aux noms des fonctions : 

<function>key</function> 

La feuille de style peut alors generer des hyperliens entre les references et les definitions 
commesuit : 

<xsl:key name="f unc" match="prototype" use="@name"/> 

<xsl :template match="function"Xbr> 
<b> 

<a href ="#(generate-id( key ( 'func' ,.))}"> 
<xsl :apply-templates/> 

</a> 

</b> 

</xsl :templ ate> 

<xsl :template match="prototype"> 

<P> 

<a name="{generate-id( )}"> 
<b> Function: </b> 

</a> 

</p> 

</xsl :templ ate> 

La fonction key( ) peut etre utilisee pour recuperer une cle a parti r d'un document autre 
que le document contenant le nceud contexte. Supposons par exemple que nous ayons un 
document contenant des references bibliographiques sous la forme <bibref>xsi_T</bibref>, 
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et qu'il y ait un document XM L separe bib.xmi contenant la base de donnees bibliogra- 
phiques, avec des entrees de la forme : 

<entry name="XSLT">. . .</entry> 

Mors, pour la transformation des elements bi bref la feuille de style peut contenir ce qui 
suit : 

<xsl:key name="bib" match="entry" use="@name"/> 

<xsl :templ ate match="bibref "> 

<xsl :variable name="name" select=" . "/> 

<xsl :for-each select="document( 'bib.xmi ' )"> 

<xsl :apply-templates select="key( 'bib' ,$name)"/> 

</xsl :for-each> 
</xsl :templ ate> 

string generate-id( node-set ) 

La fonction generate-i d( ) retourne une chaine de caracteres qui identifie d'une maniere 
unique le nceud dans le node-set recu en argument, qui est le premier nceud dans I'ordre 
de lecture du document. L'identificateur unique doit etre compose de caracteres ASCII 
alphanumeriques et doit commencer par un caractere alphabetique. C'est done un nom 
XML syntaxiquement correct. Une implementation est libre de generer un identificateur 
de la fagon qui lui est la plus appropriee, a condition que plusieurs generations successi- 
ves pour un meme nceud donnenttoujours le meme identificateur, et que deux nceuds dis- 
tincts donnent toujours des identificateurs distincts. Une implementation n'est pas 
obligee de generer les memes identificateurs chaquefois qu'un document subi une trans- 
formation. Rien ne garanti qu'un identificateur genere sera necessairement distinct de 
tous les IDs uniques specifies dans le document source. Si le node-set recu en argument 
est vide, la fonction retourne la chaine de caracteres vide. Si I'argument est omis, le 
nceud contexte est pris par defaut comme argument. 

Note 

La suite de cette section consacree a la fonction generate-id() ne fait plus partie de la traduction. 

Cette fonction a ete largement commentee, notamment dans le chapitre sur les Patterns 
de transformation. Une application inattendue est cell e qui consiste a contourner certai- 
nes interdictions syntaxiques dans les motifs associes a une regie de transformation. On 
sait qu'un motif est une expression XPath bridee (voir Syntaxe et contrainte pour un 
motif XSLT, page 98). Un jour, sur la liste de discussion XSLT de mulberrytech (xsl- 
list@lists.mulberrytech.com dont I 'archive est consumable sur www.biglist.com/lists/xsl-list/ 
archives), quelqu'un a demande comment ecrire un motif qui Concorde avec le premier 
nceud texte descendant d'un element quelconque, disons <item> (faire eventuellement 
une recherche sur Google avec « [xsl] Selecting first descendant text node»). II re?ut 
trois reponses, une erronee et deux correctes. La reponse erronee etait celle-ci : match= 
"(item//texto)[i]". Ce motif est incorrect parcequ'i I est interditderegrouper certains 
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elements d'un motif avec des parentheses. Par contre, c'est une expression XPath cor- 
rects etqui exprimebien I 'idee souhaitee. 

L'une des deux reponses correctes, envoyee par M ichael Kay, eta it celle-ci : 

text()[ generate-id( ) = generate-id( ( ancestor: :item//text( ) )[1] ) ] 

L'idee est ici de contourner I 'interdiction en placant a I'interieur du predicat les choses 
interdites, car un motif n'impose aucune contrainte particul iere aux eventuels predicats 
utilises. Done, ici, on va dire que le motif doit concorder avec n'importe quel texte, 
pourvu que... 

Le « pourvu que ... » reprend tout simplement I'expression XPath de la fausse bonne 
reponse n tern/ /text ( ))[i], en I'amenageant un peu. En effet, on peut dire, comme La 
Palice, que tout texte convient, pourvu qu'il soitle premier descendant d'un <item>, puis- 
que e'etait precisement cela la question. Comme on a un test d'identite a effectuer (ce 
texte est-il lememequetel autre?), lafonction generate-id( ) est done mise a contribu- 
tion. Etant donne un nceud texteT, la question devient : ce nceud texte est-il le meme que 
celui represents par I'expression ( ancestor: :item//text( ) )[i] eval uee avec T comme 
noeud contexte ? Cette expression represente I e premier nceud texte descendant d'un ele- 
ment item qui est un ancetre de T. Done finalement, le motif se lit : tout noeud texteT, 
pourvu qu'il soit le meme que le premier noeud texte descendant d'un element item qui 
est un ancetre deT. 

Inutile de dire qu'une telle recherche de concordance peut Stre assez couteuse en temps 
decalcul ; c'est pourquoi la conclusion de M ichael Kay fut qu'il etait probablement pre- 
ferable de repenser le probleme pour eviter d'avoir une regie avec un motif aussi etrange. 

string unparsed-entity-uri( string ) 

Lafonction unparsed-entity-uri ( ) retourne I'URI de I 'entite (non analysee par un par- 
seur XM L) dont le nom est sped fie par la string fournieen argument, et declaree dans la 
DTD du document dont le noeud contexte est issu. Si une telle entite n'existe pas, alors 
la fonction retourne une chaine de caracteres vide. 

node-set current() 

La fonction currento retourne un node-set ayant pour seul element le noeud courant. 
Pour une expression dont I 'evaluation ne depend pas d'une autre expression, le noeud 
courant se confond toujours avec le noeud contexte. A insi, 

<xsl :val ue-of sel ect="current( )"/> 

a la meme signification que : 

<xsl :val ue-of sel ect=" . "/> 

Cependant dans des crochets (i.e. dans un predicat), le noeud courant est habituellement 
different du noeud contexte. Par exemple, 



<xsl : apply- tempi ates sel ect="//gl ossary/item[@name=current( )/@ref ]"/> 
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va traiter tous les elements item qui ont un element gi ossary parent et qui ont un attri but 
name dont la valeur estegalea la valeur de I 'attri but ref du nceud courant. Ceci est diffe- 
rent de 

] <xsl :apply-templates select="//glossary/item[@name=./@ref]"/> 

qui signifie la meme chose que : 

<xsl :apply-templates select="//glossary/item[@name=@ref]'7> 

permettant de traiter tous les elements item ayant un element gi ossary parent et ayant un 
attri but name et un attri but ref qui setrouvent avoir la meme valeur. 

L' utilisation de la fonction current ( ) dans un motif est une erreur. 

Formatage de nombres 

string format-number( number, string , string ) 

La fonction to rmat-num bero convertit un nombre en une chaine de caracteres. Le pre- 
mier argument est le nombre a convertir ; le deuxieme est un motif specifiant le format de 
conversion ; le troisieme argument represented format decimal (en son absence, il y a un 
format decimal par defaut). La chaine de caracteres constituant le motif de conversion 
doit respecter la syntaxe specified par la classe Decimal Format du J DK 1.1 (Kit de deve- 
loppement Java de Sun Microsystems). Le motif de specification de format est une 
chaine localised (i.e. susceptible de subir des variations propres a la langue et aux coutu- 
mes cultu relies du pays de I ' uti I i sateur) : le format decimal determine quels sont les 
caracteres ayant une signification particuliere dans le motif (a I'exception du guillemet 
qui n'est pas localise). Le motif de format ne doit pas contenir le symbole de la devise 
monetaire (#xOOA 4) ; le support de cette caracteristi que a ete ajoute apres la livraison ini- 
tiale du JDK 1.1. Le nom du format decimal doit etre un QName (nom qualifie). La 
feuille de style doit contenir une declaration du format decimal avec ce nom qualifie, 
sinon c'est une erreur. 

Note 

Les implementations ne doivent pas forcement utiliser I'implementation du J DK 1.1, ni etre forcement realisees 
en Java. 

Note 

Rien n'empeche les feuilles de style d'utiliser d'autres moyens disponibles dans XPath pour controler I'arrondi 
des nombres. 
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Fonctions diverses 

object system-property( string ) 

L'argument de cette fonction doit etre une chaine de caracteres representant un QName 
(nom qualifie). Le QName est evalue en utilisant la declaration de domaine nominal en 
vigueur pour I 'expression en cours. La fonction system-property c ) retourne un objet 
representant la valeur de la propriete systeme identi fiee par le nom. Si une telle propriete 
systeme n'existe pas alors la chaine de caracteres vide est retournee. 

Les implementations doivent fournir les proprietes systeme suivantes qui sont toutes 
dans le domaine nominal XSLT : 

• xsi version. C'est un nombre qui indique la version de XSLT supportee par le pro- 
cesseur ; Cette valeur est 1.0 pour les processeurs XSLT implementant la version de 
XSLT sped fiee dans ce document. 

• xsl : ven dor. C'est une chaine de caracteres identi fiant le fabriquant du processeur 
XSLT. 

• xsl : vendor-ur l. C'est une chaine de caracteres qui contient une URL identi fiant le 
fabricant du processeur XSLT ; typiquement, cette URL est la page d'accueil (home 
page) du site Web du fabriquant. 

booleen element-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion eiement-avaiiabieo retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une instruction. Si le nom obtenu est dans le domaine nominal de XSLT, alors il 
reference un element defini par XSLT. Sinon, il reference une extension. Si le domaine 
nominal du nom estnul, la fonction element-avail ableo retourne la valeur faux. 

booleen function-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion function-avail ableo retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une fonction de la bibliotheque. 

Si le nom obtenu est dans le domaine nominal nul, alors il reference une fonction prede- 
fine par XPath/XSLT ; sinon, il reference une extension. 
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Axe de localisation. En anglais Axis. Point de depart d'une etape de localisation. Etant 
donne un nceud contexte, donne les nceuds qui partagent entre eux une meme relation de 
parente vis-a-vis de ce nceud contexte (parent, enfant, frere, descendant, etc.). Un axe 
de localisation peut etre direct ou retrograde, suivant qu'il contient de nceuds qui sont 
situes apresou avantlenoeud contexte, lorsqu'on suit I'ordrede lecture du document. 

Axis. VoirAxe de localisation. 

A ttributeValue Template. Voir Descripteur de valeur differ <?e d'attri but. 
BaseURI.VoirURI debase. 

Chemin de localisation. En anglais Location Path. Variante restrictive d'expression 
XPath capable de selectionner un node-set constitue de nceuds preleves dans un docu- 
ment source X M L et possedant tous une meme propriete expri mee par le chemi n de loca- 
lisation sous la forme d'une suite d'etapes de localisation. 

Context Node. Voir N«ud contexte. 

C urrent Node. Voir Nceud courant. 

Descripteur de valeur differeed'attribut. En anglais Attribute Value Template (AVT). 
C'est une forme syntaxique speciale decrivant une valeur d'attri but sous la forme d'une 
expression X Path entre accolades. 

Vis avis decette propriete, on peut classer les attributs en trois categories : ceux dont les 
valeurs sont to uj ours evaluees statiquement (ou litteralement), ceux dont les valeurs sont 
toujours interpreters dynamiquement, etceux dont les valeurs acceptees sont en principe 
litterales, mais qui admettent exceptionnellement que la valeur fournie soit interpretee 
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dynamiquement, a condition qu'elle prenne la forme d'un descripteur de valeur differee 
d'attri but. 

Determinant. En anglais Node Test. Premier filtre qui determine les nceuds interessants 
d'un axe de localisation, dans I 'expression d' une etape de localisation. 

Domaine nominal. En anglais Namespace. Un vocabulaire de nomsXML a qui I'on 
donneun nom qui prend generalementlaformed'uneURL. On trouve parfois la traduc- 
tion espace de noms. 

Distribution selective. En anglais Push processing. Traitement partiel d'un element 
suivi d'une remise de ses constituants dans la pile des elements a traiter. En XSLT, I'ins- 
truction <xsi :appiy-tempi ates> est typique de cette categorie de traitement. 

Element source litteral. En anglais Litteral Result Element. ElementXM L en dehors du 
domaine nominal deXSLT (et des extensions eventuel I ement uti I i sees) ; lecontenu d'un 
tel element XML est un modele de transformation, litteral ou non. Un element source 
litteral peutconstituer en lui-memeun modele de transformation, litteral ou non. 

Etapede localisation. En anglais Step Location. Variante restrictive d'expression X Path 
qui fournit une etape dans la construction d'un chemin de localisation. One etape filtre 
les nceuds selectionnes par I 'etape precedente. 

E space blanc. En anglais Whitespace. Caractere d'espacement (espace, tabulation, saut 
de ligne, retour chariot). 

Extraction individuelle. En anglais Pull processing. Traitement qui consiste a extraire 
une information connaissant I'endroit ou el I e se trouve. En XSLT, ^instruction 
<xsi :vaiue-of> est typique de cette categorie. 

Grouping. Voir Regroupement. 

I ndicede proximite. En anglais Proximity position. Numero d'ordred'un noeud au sein 
d'un axe de localisation relatif a un noeud contexte. Pour un axe direct, les indices de 
proximite augmentent quand on s'eloignedu noeud contexte en suivant I'ordrede lecture 
du document, alors que pour un axe retrograde, les indices de proximite augmentent 
quand on s'eloignedu noeud contexte dans I'ordre inverse de lecture du document. 

Lexeme. En anglais token. Plus petite suite decaracteres reconnuecommeformantquel- 
que chose digne d'interet par un analyseur. Dans I e contexte d'XSLT, la notion de lexeme 
intervient pour lafonction d'extension Xalan ou Saxon tokenize( ), qui decode la chalne 
de caracteres fournie, comme une suite de lexemes separes (par defaut) par des espaces 
blancs. 

Litteral Result Element. Voir Element Source Litteral. 
Location Path. Voir Chemin de localisation . 
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Modelede transformation. En anglais template. C'est le fragment de document XML 
associe a une instruction, qui decrit lecontenu decette instruction. 

Modelede transformation litteral. C'est un modele de transformation qui ne contient 
que du texte, ou des elements XM L en dehors du domaine nominal de XSLT (et des 
extensions eventuel I ement uti I i sees) ; un tel element XML est un element source literal 
(Litteral Result Element). 

Modele nomme. En anglais named template. A la memeformequ'une regie de transfor- 
mation, mais possede un attri but name (a la place de I 'attri but match) qui permet de 
I'appeler explicitement. 

Motif. En anglais pattern. Variante restrictive d'expression XPath uti I i see principale- 
ment pour specifier (par le truchement de son attri but match) sur quels nceuds telle regie 
de transformation doits'appliquer. 

Named template. Voir M odele nomme'. 

Namespace. Voir Domaine nominal. 

Node-set. Type predefini de XPath, qui representeun ensemble de nceuds au sensmathe- 
matique du terme (pas d'ordre, pas de doublon). Pas d'equivalent francais dans ce livre, 
car N ode-set est un nom de type, considers comme un nom propre. 

Node Test. Voir Determinant. 

Noeud contexte. En anglais Context Node. Nceud par rapport auquel on evalue une 
expression XPath. 

Noeud courant. En anglais Current Node. Noeud en cours de traitement. 

Pattern. Voir Motif. Dans ce livre, le mot pattern est aussi utilise au sens de pattern 
design (mise en evidence d'un type de problemeet d'unefacon deraisonner ou d'organi- 
ser son programme pour le resoudre de facon generique). 

Pattern Matching. Voir Recherche de concordance de motif. 

Predicat. En anglais Predicat. Expression XPath quelconque, qui, lorsqu'elle est appli- 
quee a un node-set et convertie en booleen, fournit un critere d'acceptation ou de rejet 
pour constituer un nouveau node-set moins peuple. 

Predicat. Voir Pre'dicat. 

Prefix. Voir Pre/zxe. 

Prefixe. En anglais Pre/fr. A breviation d'un domaine nominal placee devant un nom 
d'elementou d'attributXM L. 

Proximity position. Voir Indice de proximite. 
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Pull processing. Voir Extraction individuelle. 
Push processing. Voir Distribution selective. 

Recherche de concordance de motif. En anglais Pattern Matching. Processus de 
recherche d'une regie dontle motif (voircemot) concordeavec lenceud en cours detrai- 
tement. 

Regie de transformation. En anglais template rule. Definit une transformation elemen- 
tal re. Une regie de transformation est selection nee si son attri but match contientun motif 
qui Concorde avec le nceud en cours de traitement. 

Regie nommee. Pas de terme anglais consacre. Construction hybride, a la fois modele 
nomme (possedeun attri but name) et regie de transformation (possedeun attri but match). 

Regroupement. En anglais Grouping. Traitement au cours duquel des elements epar- 
pilles ca et la dans le document source XML sont regroupes dans le document resultat en 
fonction d'une propriety commune. Ce genre de traitement est celebre pour etre coriace a 
programmer en XSLT 1.0 ; mais pour calmer la foule en colere, le groupe de travail 
XSLT 2.0 du W3C a propose une nouvelle instruction qui devrait si mpl i fier considerable- 
ment la programmation. 

Step Location. Voir E tape de localisation. 

Template. Voir M odele de transformation. 

Templaterule. Voir Regie de transformation. 

Temporary Source Tree. A breviation TST. Arbre XML qui resulte de I'instanciation 
d'un modele de transformation propre a une declaration de variable. Cet arbre peut 
constituer une source XML secondaire, car on peut I'explorer avec une expression 
XPath, soit directement (XSLT 1.1 ou 2.0), soit apres conversion en node-set a I 'aide 
d'une fonction de conversion fournie en tant qu'extension par le processeur utilise 
(XSLT 1.0). 

Ce terme n'est pas officiel. II est derive de la proposition de M ichael Kay, Temporary 
Tree, et reprise dans le premier Working DraftXSLT 2.0 du W3C. 

Token. Voir lexeme. 

URI (Uniform Resource Identifier). Terme generique, qui designe a la fois les URL 
(Uniform Resource Locator) et les URN (Uniform Resource Name). Dans ce livre, on 
peut dire que URI etURL sont equivalents. 

URI debase. En anglais Base U Rl . URI par rapport auquel on determine un URI relatif. 
Whitespace. Voir E space blanc. 
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Livres 

II y a essentiellementdeux livres queje pourrais recommander : 

• M ichael Kay, XSLT Programmers Reference 2nd Edition, 2001, Wrox Press. 

• Jeni Tennison, XSLT and XPath On the Edge, 2001, Hungry M inds. 

Le livre de M ichael Kay est un ouvrage de reference extremement complet sur le Ian- 
gage, ecrit par I ' auteur de Saxon, I ' un des processeurs X SLT I es pi us connus. C ' est done 
une vision de I'interieur que nous apporte M ichael Kay. II offre la particularite d'etre 
structure commeun dictionnaire, cequi estclairementun avantage pour I 'utilisation cou- 
rante du developpeur averti, mais un inconvenient pour le debutant qui cherche a com- 
prendre. 

Celui dejeni Tennison est a reserver aux utilisateurs confirmes, dans la mesure ou les 
langages X SLT et X Path sont censes etre connus du lecteur, au moins dans les grandes 
lignes. Le livre explore un grand nombre de problemes, et commente les diverses solu- 
tions envisageables. 

Ressources Internet 

En dehors de ces deux livres, on trouve beaucoup de ressources sur Internet. En premier 
lieu, leW3C (XSLT du producteur au consommateur) : 

• www.w3.org/style/xSL : le point de depart pour tous les documents du W 3C concernant 
XPath et XSLT ; beaucoup de liens interessants. 
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Des sites d'extensions ou decomposantsXSLT reutilisables : 

• http://xsltsl.sourceforge.net : X SLT Standard L ibrary ; 

• www.exslt.org : le site d'EXSLT, une initiative pour proposer et favoriser des exten- 
sions « standardises ». 

Des sites d'archives de discussions concernant X Path ou X SLT : 

• www.biglist.com/lists/xsl-list/archives : I 'archive de la liste de discussion la plus active 
surXSLT ; 

• http://lists.w3.org/Archives/Public/xsl-editors/: I 'archive des discussions publiques sur 
devolution deXSLT ; 

• http://lists.w3.org/Archives/Public/www-xpath-comments/ : I 'archive des discussions publi- 
ques sur devolution deXPath ; 

• http://www.dpawson.co.uk/xsl/xslfaq.html : la « FoireAux Questions » XSLT, maintenue 
par D. Pawson. 

Des sites de documentation ou d'information sur XM L etXSL : 

• www.xmlsoftware.com/xslt, et www.xml.com/ : deux sites qui recensent des produits 
XSLT ouXML ; 

• http://msdn.microsoft.com/xml : le site M icrosoft dedie a XM L et XSL (et telecharge- 
ment deMSXML). 

• http://www.mulberrytech.com/ : un sitetres actif pour XSL. On y trouvera (entre autres) 
des aide-memoire XM L etXSLT/XPath (en PDF) tres bien faits. 

• http://xmlfr.org/ : un site en francais consacre a X M L et done a XSL (entre autres). 

• http://xml.coverpages.org/sgml-xml.html: le site de Robin Cover, une compilation de 
tout ce qui concerne XML et SG M L . 

Des sites de telechargement de produits X SL : 

• http://saxon.sourceforge.net/: le site de telechargement de Saxon, le processeur XSLT 
de M ichael Kay. 

• http://xml.apache.org/xalan-j/: le site de telechargement de X alan, I e processeur XSLT 
d'Apache. 

• www.jclark.com/xml/xt.html : le site de Xt (le processeur XSLT dejames Clark), leplus 
ancien mais toujours le plus rapide. 
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fusion d'~ 319 
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indices de proximite pour un -53 
axe direct 50 
axe retrograde 50 

B 
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C 
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chemin absolu (evaluation d'un ~) 63 
chemin de localisation 47, 62 

avec predicats 65 

cle pour la lecture d'un ~ 64 

dans un predicat 66 

formes courtes des -68 

principes de la construction d'un -47 
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(copied'un ~) 340 
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I'operateur = 43 
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381 
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la ~) 47 

de I'arbreXM L d'un document XM L 157 
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HTML 540 
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contexte devaluation d'un predicat 57 

contrainte 

des ancetres dans I'expression d'un motif 95 

pour un motif xslt 
syntaxeet~98 
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booleenne de node- set 59 

d'un RTF en node-set 209 
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copie 
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444 
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d'un texte par instruction xslxopy 340 
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xslxopy 340 
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340 

d'un domaine nominal par instruction 

xslxopy 327, 338 
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d'un namespace par instruction xslxopy 
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non conforme 443 
courant (noeud ~) 89, 191 
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xsl:attribute 329 
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329 

les instructions de -249 
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litteral 262 
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data- type (xsl:sort attribut ~) 151 

date (par la XSLT Standard Library) 378 
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d'une extension 604 
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decoupage d'une application XSLT 373 
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d'attri but - exemple469 
d'attri but (attribute value template) 269 
pour I 'attribut namespace de instruction 
xsl:attribute 329 
detection 
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defaut450 
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xsl:import 381 

xskindude 375 
determinant (node test) 54 
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difference entre noeud contexte et noeud courant 
89, 191 

differents modes de calcul d'un numero d'ordre 

(instruction xshnumber) 352 
disable-output-escaping pour instruction xsl:text 

(attribut ~) 260 
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pour xsl:value-of 131 
discriminant d'un motif 

evaluation du pouvoir -97, 98 
discriminante des motifs (capacite ~) 97 
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xsl:apply-imports 390 
xsl: import 385 
document 
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source X M L secondaire (utilisation de la 
fonction documentf) pour externaliser un ~) 
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XML (construction de I'arbreX M L d'un ~) 
157 

XML source (traitement du ~) 87 
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d'un ~) 30 
document!) 

fonction Saxon/XSLT 1.1 508 

fonction standard -227 

pour externaliser un document source X M L 
secondaire (utilisation de la fonction ~) 227 
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par I'instruction xshcopy (copie d'un ~) 327, 
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selection de la valeur d'un attribut dans un 
certain -331 
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dans le modele arborescent X Path (noeud de 
type ~) 31 
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63 
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expression (evaluation d'une ~) 71 
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evaluation 

d'un chemin absolu 63 
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95 
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document!) - Saxon/XSLT 1.1 508 
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exemple462 

pattern de programmation 396 
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fusion d' attribute- sets 319 
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de documents multiples 563 
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d'un appel de modele nomme 230 

d'un modele nomme 222, 230 

d'un modele (modification du noeud courant 
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xsLimport 381 
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copie d'un texte 340 
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copie du nceud root 339 
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xshdecimal-format 612 
xshelement 272 

attribut use-attribute- sets 289, 305, 307 
xshfallback 609 
xsl:for-each 137 
xshif 169 
xshimport 381 

detection de conflits 381 

instanciation de I' 381 

interet de I' 385 
xshinclude 374 

detection de conflits I' 375 

instanciation de I' 375 

interet de I' 377 
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xsl:key 235 
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differents modes de calcul d'un numero 
d'ordre 352 

numero d'ordre dans un document source 
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numero d'ordre sans decompte 363 

reinitialisation d'un numero d'ordre 360 

rendu de la numerotation 368 
xshoutput 610 
xshparam 216 
xshpreserve- space 610 
xsl:processing-instruction 343 
xshsort 144 

xsl: strip- space 172, 471, 473, 610 

xshstylesheet 603 

xsl:template 128, 219 

xsl:text 250 

attribut disable-output-escaping pour -260 

xsl:value-of 102, 128 
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instructions menageres 603 
iteration (pattern de programmation) 400 
iteration par la methode de Piez 403 
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key (fonction) 237 
key() - exemple462 

L 

lancementdu processeurXSLT 83 
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listecourantedans le modele de traitement XSLT 
88 

liste de noeuds source (traitement d'une ~) 88 
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localisation 

axes de - 49 

chemin de -47, 62 

d'une application 533 
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M 

machine deTuring 167 

methode 
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de Piez (iteration par la ~) 403 
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439, 474 

minimum d'un node-set avec le pattern visiteur 
411 
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templates 134 
modele arborescent d'un document X M L vu par 

X Path 30 
modele arborescent X Path 

noeud de type attribute dans le ~ 33 
noeud de type comment dans le ~ 35 
noeud de type element dans le ~ 31 
noeud de type namespace dans le ~ 34 
noeud de type processing-instruction dans le ~ 
35 

noeud de type root dans le ~ 31 

noeud de type text dans le ~ 36 
modele de traitement 87 
modele de transformation 79 

litteral 81 
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modele nomme 
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motif 

capacite discri minante 97 
concordance 92 

contrainte des ancetres dans I'expression 
d'un -95 

evaluation du pouvoir discriminantd'un -97, 
98 

exemplede~98 

par rapport a un noeud contexte (evaluation 
d'un ~) 92 

recherche de la concordance (pattern mat- 
ching) 94 

X SLT (syntaxe et contrainte pour un ~) 98 
mots dans une string (decompte de ~) 405 
M uench Steve (regroupements par la methode 
de ~) 474 

N 

namespace 

axe de localisation 49 

dans le modele arborescent X Path (nceud de 
type ~) 34 

descripteur de valeur differee pour I'attribut 
namespace de ^instruction x si: attribute 329 
explicite 450 

par defaut (detection d'un element dans un ~) 
450 

par defaut (namespace explicite) 450 
par I 'instruction xshattribute (creation d'un ~) 
329 

par ^instruction xslxopy (copie d'un ~) 327, 
338 

namespace-alias (instruction ~) 508 

node test, ou determinant, dans une etape de 

localisation 54 
node- set 

application d'un predicate une expression 

renvoyantun -72 
comparaison avec I'operateur = 43 
conversion d'un RTF en -209 
de valeurs toutes differentes 438 
enumeration d'un -53 

evaluation d'uneetapede localisation par rap- 
port a un -63 
expressions avec arguments de type - 42 
renvoye par une expression (enumeration 
d'un ~) 71 

renvoye par une expression (evaluation d'une 
etape de localisation par rapport a un ~) 71 

serialisation d'un - 157 

variantes syntaxiques d'expressions ren- 
voyantun -70 
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X Path 33 

de type comment dans le modele arborescent 
X Path 35 

de type element dans le modele arborescent 
X Path 31 

de type namespace dans le modele arbores- 
cent X Path 34 

detype processing-instruction dans le modele 
arborescent X Path 35 

de type root dans le modele arborescent 
X Path 31 

detype textdans lemodelearborescentX Path 
36 

noeud contexte 47, 89, 191 

et nceud courant (difference entre ~) 89, 191 
evaluation d'un motif par rapport a un -92 

noeud courant 89, 191 

dans le modele de traitement X SLT 88 
difference entre noeud contexte et -89, 191 
pendant I'instanciation d'un modele (modifi- 
cation du ~) 141 

noeud source 

membre d'une liste de nceuds source 

(traitement d'un ~) 88 
traitement d'une liste 88 

nombres 41 

noms de variables (conflits de ~) 214 
normalize-space() (fonction standard ~) 252 
numero d'ordre 

dans un document source secondai re 
(instruction xshnumber) 367 

sans decompte (instruction xslinumber) 363 

0 

obtention de la valeur d'une variable 184 
operateur = 

node-sets : comparaison avec I' 43 
operations 

sur un RTF (ResultTree Fragment) en XSLT 
1.0 209 

sur un TST (Temporary SourceTree) 198 
order (xshsort, attribut ~) 151 
ordre de lecture d'un document 50, 446 

P 

pages HTM L dynamiques (generation de ~) 518 
pape (regie du ~) 293, 335, 338 
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parametre 

global (utilisation d'un ~) 217 

local (utilisation d'un ~) 219 

xsl:param 216 
parent (axe de localisation) 49 
pattern 393 

de programmation 395 

de transformation 443 

visiteur (minimum d'un node-set avec le ~) 
411 

visiteur (somme des valeurs d'un node-set 
avec le ~) 416 
pattern matching (recherche de la concordance 

de motifs) 94 
pattern 

Voir aussi motif 
Piez (iteration par la methode de ~) 403 
pipe (regie du ~) 384 
position des instructions xshinclude 376 
positionnel (regroupement ~) 474 
pouvoir discriminant d'un motif 

evaluation du -98 
pouvoir discriminant d'un motif (evaluation 
du ~) 97 

preceding (axe de localisation) 49 
preceding-sibling 
axe de localisation 49 
regroupements par -438 
predicat 57 

a une expression renvoyant un node-set 

(application d'un ~) 72 
contexte devaluation d'un -57 
fonction current() dans un -473 
preseance des feuilles importees par xshimport 

(calcul dela~) 381 
principe de fonctionnement d'un processeur 

XSLT 83 
priorite (forcage de la ~) 101 
priorites entre regies 100 
priorites par defaut (algorithme de calcul des ~) 
100 

processeur XSLT 
lancement du -83 

principe de fonctionnement d'un -83 
processing- instruction 

dans le modele arborescent X Path (nceud de 
type ~) 35 

par instruction xslxopy (copie d'une ~) 340 
programmation 

en XSLT (les possibility de ~) 167 
les instructions de -167 
patterns de - 395 



programme XSLT (structure d'un ~) 75 
proximite pour un axe de localisation 
indices de -53 

Ft 

recherche de la concordance de motifs (pattern 

matching) 94 
recursion (pattern de programmation) 405 
referencer une variable 184 
references croisees inter fichiers 459 
regie 

de transformation 78 

de visibilite pour les variables globales 212 
de visibilite pour les variables locales 214 
du pape293, 335, 338 
du pipe 384 

modele nomme (hybride xslitemplate) 219 
par defaut 119 

pour la racine d'un arbre X M L ou un 
element 120 
pour un noeud de type comment ou 

processing-instruction 120 
pour un noeud de type text ou attribute 120 
priorites 100 

XSLT (forme d'une-) 79 
regroupement 

hierarchique 474 

methode de la cle 439, 474 

par la methode de Steve M uench 439, 474 

par preceding-sibling 438 

par valeur 474 

positionnel 474 
reinitialisation d'un numero d'ordre (instruction 

xslinumber) 360 
rendu de la numerotation (instruction xsl:number) 
368 

ResultTree Fragment 

en XSLT 1.0 167,208 

en X SLT 1.0 (operations sur un ~) 209 
ResultTree Fragment 

Voir aussi RTF 167 
root 

dans le modele arborescent X Path (noeud de 
type ~) 31 

par instruction xslxopy (copie du noeud ~) 
339 

RTF (ResultTree Fragment) 

en node-set (conversion d'un ~) 209, 423 
en X SLT 1.0 (operations sur un ~) 209 
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saxon:evaluate() 549 

saxon:tokenize() 557 

secondaire (TST, source X M L ~) 192 

select (xshsort, attri but ~) 151 

select="...", variante syntaxique pour xshapply- 

templates 133 
selection de la valeur d'un attri but dans un cer- 
tain domaine nominal 331 
self (axe de localisation) 49 
serialisation 

d'unarbreXML 157, 159 
d'un node- set 157 
somme des valeurs d'un node- set avec le pattern 

visiteur416 
Source Tree (Temporary ~) 

Voiraussi TST 192 
source XM L secondaire 

exemple d'utilisation d'un TST comme -223 
TST, -192 
string 

action instancier-bourre pour une -402, 404 
decompte de mots dans une - 405 
en morceaux (decoupe d'une ~) 419 
fonction index-of(-) 397 

structure 

d'un programme X SLT 75 
dedonneesauxilaire- pattern deprogramma- 
tion (utilisation d'une ~) 422 

syntaxe et contrainte pour un motif XSLT 98 

T 

table d'associations 237 
Temporary SourceTree 
calcule 196 

equivalent a un texte 196 
forme degeneree d'un - 196 
forme generale d'un - 194 
obtenu litteralement 193 
operations sur un -198 
texte 196 

text dans le modele arborescent X Path (noeud 

de type ~) 36 
texte 

par instruction xslxopy 

copied'un -340 
Temporary SourceTree equivalent a un -196 
X M L par un element source I itteral (creation 
de ~) 262 

tokenizef) (extension saxon ou xalan ~) 557 
traduction par dictionnaire 227 
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des espaces blancs 252 
du document XML source 87 
modele de -87 
transformation 
patterns de -443 
regies de -78 

relativement a un noeud courant et une liste 
courante (instanciation d'un modele de ~) 
90 

XML - RTF 579 
transmission d'argument 
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523 

Tree (Temporary Source ~) 

Voiraussi TST 192 
Tree Fragment (Result ~) en X SLT 1.0 

Voiraussi RTF 208 
tri (xshsort, attri buts specifiant les parametres 

d'un ~) 151 
TST (Temporary SourceTree) 192 

calcule 196 
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d'utilisation d'un ~) 223 
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exemples d'utilisation d'un - 199 

forme degeneree d'un - 196 

obtenu litteralement 193 

operations sur un -198 
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texte 196 
Turing (machine de ~) 167 
Turing-complet(XSLT ~) 167 

U 

URI debase 640 
use-attribute-sets 

pour instruction xshattribute- set (attri but ~) 
307 

pour instruction xslxopy (attri but ~) 324, 
335 

pour instruction xslxlement (attri but-) 289, 
305, 307 
utilisation 

d'un TST comme source XML secondaire 

(exemple d'~) 223 
d'un TST enXSLTl.l ou plus (exemples d'~) 

199 



Index 



661 



d'une structure de donnees auxilaire - pattern 

de programmation 422 
d'une variable 184 
utiliser une variable 
globale 187 
locale 185 

V 

valeur 

d'un attri but dans un certain domaine nominal 

(selection de la ~) 331 
d'une variable (obtention de la ~) 184 
differee d'attribut (attribute value template) 

269 

regroupement par -474 
variable 

conflits de noms de -214 
globale 187 

circularity dans la declaration de -212 
evaluation d'une - 187 
regies de visibility 212 
globale et locale 184 
locale 185 

regies de visibility 214 
obtention de la valeur d'une - 184 
referencer une - 184 
utilisation d'une -184 
xsl:variable 179 
variantes syntaxiques d'expressions renvoyant 

un node-set 70 
visibility 

pour les variables globales (regies de ~) 212 
pour les variables locales (regies de ~) 214 
visiteur 

minimum d'un node-set avec le pattern -411 
recursif de node-set (pattern de program- 
mation) 409 
somme des valeurs d'un node- set avec le 
pattern -416 

X 

xalan:evaluate() 549 
xalan:tokenize() 557 
XPath 

expressions -40 

le langage -29 

modele arborescent d'un document X M L vu 
par -30 

xsl (abreviation courante de domaine nominal 

pourXSLT) 75 
xshapply-imports (instruction ~) 388 



xshapply-templates 

avec transmission d'argument (instruction ~) 

233, 523 
instruction -107, 131, 233 
mode-'...", variante syntaxique pour - 134 
select ="...", variante syntaxique pour - 133 
xsl: attribute 

creation d'un domaine nominal par instruc- 
tion -329 

creation d'un namespace par I'instruction - 
329 

descripteur de valeur differee pour I 'attri but 
namespace de I'instruction -329 

instruction -289 
xsl :attri bute-set 

attri but use-attribute-sets pour I'instruction - 
307 

instruction -304 
xslxall-template (instruction ~) 229 
xsl xhoose (instruction ~) 174 
xslxomment (instruction ~) 340 
xslxopy 

attri but use-attribute-sets pour I'instruction - 
324, 335 

copie d'un attri but par I'instruction -335 
copie d'un commentaire par I'instruction - 
340 

copie d'un domaine nominal par 

I'instruction -327, 338 
copie d'un element par I'instruction -326 
copied'un namespace par I'instruction -327, 

338 

copie d'un texte par I'instruction -340 
copie d'une processing-instruction par 

I'instruction -340 
copie du noeud root par I'instruction -339 
equivalence avec xsl xlement pour un element 

334 

instruction -321 
xslxopy-of (instruction ~) 156 
xshdecimal-format 
instruction -612 
xshelement 

attri but use-attribute-sets pour I'instruction - 

289, 305, 307 
equivalence avec xslxopy pour un element 
334 

instruction -272 
xshfallback (instruction ~) 609 
xsl:for-each (instruction ~) 137 
xsl :if (instruction ~) 169 



662 



XSLT professionnel 



xshimport 

calcul de la preseance des feuilles importers 
par -381 

detection de conflits dus a I 'instruction -381 
instanciation de instruction -381 
instruction -381 
interetde instruction -385 
xshinclude 

detection de conflits dus a instruction -375 

instanciation de instruction -375 

instruction -374 

interetde instruction -377 

position des instructions -376 
x si: key 

exemple462 

instruction -235 
xshmessage (instruction ~) 234 
xsl:namespace-alias (instruction ~) 607 
xshnumber 

arbre source XM L explore lors de instancia- 
tion de instruction -350, 367 

differents modes de calcul d'un numero 
d'ordre 352 

instruction -344 

numero d'ordre dans un document source 
secondaire 367 

numero d'ordre sans decompte 363 

reinitialisation d'un numero d'ordre 360 

rendu de la numerotation 368 
xshoutput (instruction ~) 610 
xshparam 

instruction -216 

parametre -216 
xsl:preserve-space (instruction ~) 610 
xshprocessing-instruction (instruction ~) 343 



xsl:sort 

attri but case-order 151 
attri but data-type 151 
attri but lang 151 
attri but order 151 
attri but select 151 

attri buts specifiant les parametres d'un tri 151 

instruction - 144 
xshstrip-space (instruction ~) 172, 471, 473, 610 
x si: stylesheet (instruction ~) 603 
xsl :template 

instruction -128, 219 

modele nomme -219 
xsl :text 

attri but disable-output-escaping pour instruc- 
tion -260 
instruction -250 
xsl :use-attri bute-sets pour un element source 

litteral (attri but-) 312 
xsl:value-of 

disable-output-escaping="...", variante 

syntaxique pour -131 
instruction -102, 128 
xshvariable 179 

instruction -179 
XSLT 

lancement du processeur - 83 
les possibility de programmation en - 167 
principedefonctionnementd'un processeur - 
83 

Standard Library (XSLTSL) 377, 617 
structure d'un programme - 75 
Turing-complet 167 
XSLTSL (XSLT Standard L ibrary) 377, 617 



